GroupByArea Property (DataPresenterBase)

Returns the GroupByArea
Public Property GroupByArea As GroupByArea
public GroupByArea GroupByArea {get; set;}

The GroupByArea provides a UI for grouping data records based on Fields defined in the DefaultFieldLayout. Since there is only one DefaultFieldLayout, the GroupByArea can only provide a grouping UI for that FieldLayout. By default, the DefaultFieldLayout is set to the FieldLayout associated with the first DataRecord encountered. When bound to flat homogeneous data this is not an issue since there is only one FieldLayout. Keep in mind that if the control is bound to non-homogeneous data or hierarchical data the grouping UI will only show the Fields from the DefaultFieldLayout.

Note: To support grouping of heterogenous data or hierarchical data use the GroupByAreaMulti property and set the GroupByAreaMode property to MultipleFieldLayoutsFull or MultipleFieldLayoutsCompact.

Refer to the About Grouping topic in the Developer's Guide for an explanation of how this property is used.


Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also