Xceed Logo
Shop
Xceed Toolkit Plus for WPF v5.1 Documentation
Xceed.Wpf.DataGrid.Toolkit Assembly / Xceed.Wpf.DataGrid Namespace / DataGridGroupDescription Class
Example


In This Topic
    DataGridGroupDescription Class
    In This Topic
    Class that describes the grouping of items using a property name as the criteria.
    Object Model
    DataGridGroupDescription ClassGroupConfiguration Class
    Syntax
    '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. 
    <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

    Public Constructors
     NameDescription
    Public ConstructorDataGridGroupDescription ConstructorOverloaded.   
    Top
    Public Properties
     NameDescription
    Public PropertyCustomSort (Inherited from System.ComponentModel.GroupDescription)
    Public PropertyGroupConfigurationGets or sets the group configuration that will be applied to the groups created by this group description.  
    Public PropertyGroupNames (Inherited from System.ComponentModel.GroupDescription)
    Public PropertyPropertyNameGets or sets the name of the property that is used to determine which group an item belongs to.  
    Public PropertySortComparerGets or sets the data comparer that will be used to sort the groups in a grid.  
    Public PropertySortDescriptions (Inherited from System.ComponentModel.GroupDescription)
    Top
    Public Methods
     NameDescription
    Public MethodGroupNameFromItemOverridden. Retrieves the group name for the specified item.  
    Public MethodNamesMatchOverridden. Returns a value indicating whether the group name and the item name match, which means that the item belongs to the group.  
    Top
    Protected Methods
     NameDescription
    Protected MethodGetPropertyValueRetrieves the property value for the specified item.  
    Protected MethodOnPropertyChanged (Inherited from System.ComponentModel.GroupDescription)
    Top
    Protected Events
     NameDescription
    Protected EventPropertyChanged (Inherited from System.ComponentModel.GroupDescription)
    Top
    Supported Frameworks

    .NET: net5.0, net5.0-windows, net6.0, net6.0-macos, net6.0-windows, net7.0, net7.0-macos, net7.0-windows, net8.0, net8.0-browser, net8.0-macos, net8.0-windows, net9.0, net9.0-browser, net9.0-macos, net9.0-windows, net10.0, net10.0-browser, net10.0-macos, net10.0-windows.

    .NET Framework: net40, net403, net45, net451, net452, net46, net461, net462, net463, net47, net471, net472, net48, net481.

    See Also

    Reference

    DataGridGroupDescription Members
    Xceed.Wpf.DataGrid Namespace

    Send Feedback