ESRI.ArcGIS.ADF.Web.UI.WebControls
GroupResultsByTable Property
See Also 
ESRI.ArcGIS.ADF.Web.UI.WebControls Namespace > FloatingPanelTask Class : GroupResultsByTable Property




Whether the results of this task will have the results grouped by layers, or if false, display directly under the top-level result node.

Syntax

Visual Basic (Declaration) 
<PersistenceModeAttribute()>
<ResCategoryAttribute("Task")>
<BrowsableAttribute(True)>
<NotifyParentPropertyAttribute(True)>
<DefaultValueAttribute()>
<ResDescriptionAttribute("Whether the results of this task will have the results grouped by layers.")>
Public Overridable Property GroupResultsByTable As Boolean
Visual Basic (Usage)Copy Code
Dim instance As FloatingPanelTask
Dim value As Boolean
 
instance.GroupResultsByTable = value
 
value = instance.GroupResultsByTable
C# 
[PersistenceModeAttribute()]
[ResCategoryAttribute("Task")]
[BrowsableAttribute(true)]
[NotifyParentPropertyAttribute(true)]
[DefaultValueAttribute()]
[ResDescriptionAttribute("Whether the results of this task will have the results grouped by layers.")]
public virtual bool GroupResultsByTable {get; set;}

Remarks

Task results are arranged in a hierarchy of data. These results display as a nested set of nodes in a TaskResults control in a tree-view fashion. The user expands the nodes to display nested information. When GroupResultsByTable is true (the default), these results have up to four levels: task result node, layer node(s), feature or table node(s), and attribute node. To display feature nodes, the tree must therefore be expanded two levels.

If GroupResultsByTable is false, the results have only three levels: task result nodes, feature nodes(s), and attribute node. Therefore the features display immediately below the top-level task result node.

Behind the scenes, the task results typically are a DataSet, which contains one or more DataTables or GraphicsLayers (which inherit from DataTable). Then GroupResultsByTable is true, the tables/feature layers are passed as separate nodes in the hierarchy to the TaskResults control. When GroupResultsByTable is false, the records within all tables/feature layers are pulled within a single table under the main task result node.

Setting GroupResultsByTable to false is typically most appropriate when the results contain information about only one layer or otherwise are a single type of data. For example, the QueryAttributesTask queries only a single layer of data, and may be suitable for a setting of false. The SearchAttributesTask, on the other hand, may return data from multiple layers, so that a setting of true may be more appropriate.

See Also

© 2010 All Rights Reserved.