GridControl.DataSource Property

OBSOLETE

Instead use the ItemsSource property. For detailed information, see the list of breaking changes in DXperience v2011 vol 1.

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

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v20.2.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Grid.Core, DevExpress.Wpf.Grid.Core

Declaration

C#

[Obsolete("Instead use the ItemsSource property. For detailed information, see the list of breaking changes in DXperience v2011 vol 1.")]
[Browsable(false)]
[Bindable(true)]
public object DataSource { get; set; }

VB.NET

<Obsolete("Instead use the ItemsSource property. For detailed information, see the list of breaking changes in DXperience v2011 vol 1.")>
<Browsable(False)>
<Bindable(True)>
Public Property DataSource As Object

Property Value

Type	Description
Object	An object that represents the data source from which the grid retrieves its data.

Remarks

Use the DataControlBase.ItemsSource property.

Example

This example demonstrates how to read data from an XML file and display it using the GridControl. If required, the changes made can be saved back to an XML file by clicking the button displayed below the grid.

View Example

Window1.xaml

<Window x:Class="DXGrid_BindingToXML.Window1"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
        xmlns:dxg="http://schemas.devexpress.com/winfx/2008/xaml/grid"
        Title="Window1">
    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition />
            <RowDefinition Height="30" />
        </Grid.RowDefinitions>

        <dxg:GridControl 
            x:Name="grid" 
            VerticalAlignment="Top">
            <dxg:GridControl.Columns>
                <dxg:GridColumn FieldName="FirstName" />
                <dxg:GridColumn FieldName="LastName" />
                <dxg:GridColumn FieldName="Company" />
                <dxg:GridColumn FieldName="City" />
            </dxg:GridControl.Columns>
            <dxg:GridControl.View>
                <dxg:TableView AutoWidth="True" />
            </dxg:GridControl.View>
        </dxg:GridControl>
        <Button Margin="5" Grid.Row="1" Click="Button_Click" 
                VerticalAlignment="Bottom" HorizontalAlignment="Left" 
                Content="Post Data to an XML File"/>
    </Grid>
</Window>

Window1.xaml.cs

using System.Windows;
using System.Data;

namespace DXGrid_BindingToXML {

    public partial class Window1 : Window {
        static string path = @"..\..\Contacts.xml";
        public Window1() {
            InitializeComponent();
            grid.ItemsSource = GetDataFromXML();
        }
        private DataTable GetDataFromXML() {
            DataSet ds = new DataSet();
            ds.ReadXml(path);
            return ds.Tables[0];
        }
        private void PostDataToXML() {
            ((DataTable)grid.ItemsSource).DataSet.WriteXml(path);
        }

        private void Button_Click(object sender, RoutedEventArgs e) {
            PostDataToXML();
            MessageBox.Show("Changes have been successfully saved to an XML file.", "Info");
        }
    }

}

Window1.xaml.vb

Imports System.Windows
Imports System.Data

Namespace DXGrid_BindingToXML

    Partial Public Class Window1
        Inherits Window

        Private Shared path As String = "..\..\Contacts.xml"
        Public Sub New()
            InitializeComponent()
            grid.ItemsSource = GetDataFromXML()
        End Sub
        Private Function GetDataFromXML() As DataTable
            Dim ds As New DataSet()
            ds.ReadXml(path)
            Return ds.Tables(0)
        End Function
        Private Sub PostDataToXML()
            CType(grid.ItemsSource, DataTable).DataSet.WriteXml(path)
        End Sub

        Private Sub Button_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
            PostDataToXML()
            MessageBox.Show("Changes have been successfully saved to an XML file.", "Info")
        End Sub
    End Class

End Namespace

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DataSource 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

how-to-place-custom-control-at-the-bottom-of-gridcontrol-e3544/CS/Q346919/MainWindow.xaml#L9

<Grid>
    <dxg:GridControl DataSource="{Binding}">
        <dxg:GridControl.View>

how-to-prevent-individual-cells-from-being-edited-t608057/CS/DXGridSample/Window17.xaml#L21

<dxg:GridControl DataSource="{x:Static local:MyData.Data}" AutoPopulateColumns="true" Name="grid" Margin="0,0,0,0" AutoExpandAllGroups="True">

wpf-dock-layout-manager-serialize-a-particular-panels-layout/CS/DX WPF Application10/MainWindow.xaml#L26

<dxg:GridControl AutoPopulateColumns="True" ShowBorder="False">
    <dxg:GridControl.DataSource>
        <collections:ArrayList>

wpf-dock-layout-manager-serialize-custom-panels-and-their-properties/CS/DX WPF Application10/MainWindow.xaml#L26

<dxg:GridControl AutoPopulateColumns="True" ShowBorder="False">
    <dxg:GridControl.DataSource>
        <collections:ArrayList>

Reporting_how-to-update-the-print-preview-according-to-the-changes-made-in-dxgrid-e2964/CS/PrintDXGridSample/MainWindow.xaml#L18

</Grid.RowDefinitions>
<dxg:GridControl x:Name="gridControl" DataSource="{Binding Persons}">
    <dxg:GridControl.Columns>