DataGridGroupDescription Class

Class that describes the grouping of items using a property name as the criteria.

Syntax

Visual Basic
C#

'Declaration
 
Public Class DataGridGroupDescription 
   Inherits System.ComponentModel.GroupDescription

'Usage
 
Dim instance As DataGridGroupDescription

public class DataGridGroupDescription : System.ComponentModel.GroupDescription

Remarks

This class is used by the DataGridCollectionView class to group items; however, it can also be used by the standard CollectionView class.

The use of the GroupNames property is not supported by the DataGridGroupDescription class.

Example

All examples in this topic assume that the grid is bound to the Orders table of the Northwind database, unless stated otherwise. See also examples in GroupNameFromItem method.

The following example demonstrates how to group the data items by the ShipCountry and ShipCity columns.

XAML

<Grid xmlns:xcdg="http://schemas.xceed.com/wpf/xaml/datagrid">
  <Grid.Resources>
    <xcdg:DataGridCollectionViewSource x:Key="cvs_orders"
                                    Source="{Binding Source={x:Static Application.Current},
                                                      Path=Orders}">       

     <xcdg:DataGridCollectionViewSource.GroupDescriptions>         
       <xcdg:DataGridGroupDescription PropertyName="ShipCountry"/>
       <xcdg:DataGridGroupDescription PropertyName="ShipCity"/>
     </xcdg:DataGridCollectionViewSource.GroupDescriptions>
    </xcdg:DataGridCollectionViewSource>
  </Grid.Resources>
   
  <xcdg:DataGridControl x:Name="OrdersGrid"
                        ItemsSource="{Binding Source={StaticResource cvs_orders}}">     
  </xcdg:DataGridControl>
</Grid>

Inheritance Hierarchy

System.Object
System.ComponentModel.GroupDescription
Xceed.Wpf.DataGrid.DataGridGroupDescription

Requirements

Target Platforms: Windows 11, Windows 10, Windows 7, 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

Reference

DataGridGroupDescription Members
Xceed.Wpf.DataGrid Namespace