DataControlBase.ColumnsSource Property

Gets or sets the source from which the grid generates columns. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v21.2.Core.dll

NuGet Package: DevExpress.Wpf.Grid.Core

Declaration

C#

public IEnumerable ColumnsSource { get; set; }

VB.NET

Public Property ColumnsSource As IEnumerable

Property Value

Type	Description
IEnumerable	The source from which the grid generates columns.

Remarks

You can define columns in a ViewModel and display them in the GridControl. To do this, follow the steps below:

1. Create a collection of grid columns in a ViewModel.

2. Specify a data template that generates columns:

   XAML

   <Window.Resources>
       <DataTemplate x:Key="DefaultColumnTemplate">
           <dxg:GridColumn FieldName="{Binding Path=(dxci:DependencyObjectExtensions.DataContext).FieldName, RelativeSource={RelativeSource Self}}"/>
       </DataTemplate>
   </Window.Resources>
   

3. Assign the column collection to the ColumnsSource property and the column template to the ColumnGeneratorTemplate property:

   XAML

   <dxg:GridControl ...
                    ColumnsSource="{Binding Columns}" 
                    ColumnGeneratorTemplate="{StaticResource DefaultColumnTemplate}"/>
   

When you reorder columns in the GridControl, the order of items in the collection bound to the ColumnsSource property does not change. Use the BaseColumn.VisibleIndex property to get column positions and process them in your collection.

Refer to the following help topic for more information: How to: Bind the Grid to a Collection of Columns.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ColumnsSource property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

wpf-data-grid-bind-columns-to-viewmodel-collection/CS/ColumnsSample/MainWindow.xaml#L35

</Window.Resources>
<dxg:GridControl ItemsSource="{Binding Source}" ColumnsSource="{Binding Columns}"
                 ColumnGeneratorTemplateSelector="{StaticResource ColumnTemplateSelector}">