DataControlBase.ItemsSource Property

Gets or sets the grid’s data source. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

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

NuGet Package: DevExpress.Wpf.Grid.Core

Declaration

C#

[Bindable(true)]
public object ItemsSource { get; set; }

VB.NET

<Bindable(True)>
Public Property ItemsSource As Object

Property Value

Type	Description
Object	A data source from which the grid retrieves its data.

Remarks

The grid cannot operate without a data source. It can be bound to data from a database, from an XML file, or to any data created at runtime. The grid can be bound to any object that implements the IEnumerable interface or its descendant (e.g. IList, ICollection). To bind a grid, you should assign a data source to the ItemsSource property. Note that the grid cannot be bound at design-time - only at runtime.

View Example: Bind the WPF Data Grid to Data

Tip

Topic: Binding to Data Overview

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ItemsSource 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-implement-crud-operations/CS/ViewModel/EFCore/LocalData/MainWindow.xaml#L27

<dxg:GridControl x:Name="grid" Grid.Row="1"
                 ItemsSource="{Binding ItemsSource}" RestoreStateKeyFieldName="Id"
                 RestoreStateOnSourceChange="True">

how-to-bind-wpf-grid-to-data/CS/ViewModel/EFCore/LocalData/MainWindow.xaml#L11

<Grid>
    <dxg:GridControl x:Name="grid" ItemsSource="{Binding ItemsSource}">
        <dxg:GridControl.View>

wpf-bind-gridcontrol-to-dynamic-data/CS/VirtualSources.InfiniteAsyncSource/MainWindow.xaml#L16

<dxg:GridControl AutoGenerateColumns="AddNew">
    <dxg:GridControl.ItemsSource>
        <dx:InfiniteAsyncSource CustomProperties="{Binding CustomFields}" FetchRowsCommand="{Binding FetchRowsCommand}" />

wpf-data-grid-extend-crud-operations/CS/AsyncCRUDOperations/MainWindow.xaml#L20

</dxb:ToolBarControl>
<dxg:GridControl x:Name="grid" ItemsSource="{Binding ItemsSource}" RestoreStateKeyFieldName="Id" RestoreStateOnSourceChange="True" Grid.Row="1">
    <dxmvvm:Interaction.Behaviors>

wpf-data-grid-specify-row-visibility-in-viewmodel/CS/CustomFilteringMVVM/MainWindow.xaml#L30

<dxg:GridControl AutoGenerateColumns="AddNew" Grid.Row="1" Grid.Column="0" ItemsSource="{Binding Data}"/>
<dxg:GridControl AutoGenerateColumns="AddNew" Grid.Row="1" x:Name="grid" Grid.Column="1" ItemsSource="{Binding Data}"

C#

how-to-show-images-in-a-column-filter-drop-down-window-e3941/CS/Default MVVM/FilterPopupConverter.cs#L43

GridControl grid = value as GridControl;
ObservableCollection<TestDataViewModel> source = grid.ItemsSource as ObservableCollection<TestDataViewModel>;
source = GetUniqueValues(source);

wpf-data-grid-display-detail-content-in-tabs/CS/WpfApplication18/MainWindow.xaml.cs#L49

newGrid.View.DetailHeaderContent = "Employees";
newGrid.ItemsSource = Employees;
return newGrid;

wpf-data-grid-display-custom-content-in-grid-details/CS/WpfApplication18/MainWindow.xaml.cs#L49

newGrid.View.DetailHeaderContent = "Employees";
newGrid.ItemsSource = Employees;
return newGrid;

how-to-emulate-binding-to-the-isexpanded-property-of-the-treelistnode-t127638/CS/DevExpress.Example04/BindableExpandingBehavior.cs#L42

INotifyCollectionChanged collection = (INotifyCollectionChanged)grid.ItemsSource;
if(collection != null) {

wpf-data-grid-create-custom-gridcontrol-that-displays-horizontal-columns/CS/dxExample/VGrid/VerticalGridControl.cs#L74

void OnRowsCollectionChanged(object sender, NotifyCollectionChangedEventArgs e) {
    base.ItemsSource = Rows;
}

VB.NET

how-to-show-images-in-a-column-filter-drop-down-window-e3941/VB/Default MVVM/FilterPopupConverter.vb#L38

Dim grid As GridControl = TryCast(value, GridControl)
Dim source As ObservableCollection(Of TestDataViewModel) = TryCast(grid.ItemsSource, ObservableCollection(Of TestDataViewModel))
source = GetUniqueValues(source)

wpf-data-grid-display-detail-content-in-tabs/VB/WpfApplication18/MainWindow.xaml.vb#L37

newGrid.View.DetailHeaderContent = "Employees"
newGrid.ItemsSource = Employees
Return newGrid

wpf-data-grid-display-custom-content-in-grid-details/VB/WpfApplication18/MainWindow.xaml.vb#L45

newGrid.View.DetailHeaderContent = "Employees"
newGrid.ItemsSource = Employees
Return newGrid

how-to-emulate-binding-to-the-isexpanded-property-of-the-treelistnode-t127638/VB/DevExpress.Example04/BindableExpandingBehavior.vb#L47

Dim collection As INotifyCollectionChanged = CType(grid.ItemsSource, INotifyCollectionChanged)
If collection IsNot Nothing Then

wpf-data-grid-create-custom-gridcontrol-that-displays-horizontal-columns/VB/dxExample/VGrid/VerticalGridControl.vb#L92

Private Sub OnRowsCollectionChanged(ByVal sender As Object, ByVal e As NotifyCollectionChangedEventArgs)
    MyBase.ItemsSource = Rows
End Sub