Series.DataSource Property

Gets or sets a datasource which contains series data points.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v24.1.dll

NuGet Package: DevExpress.Wpf.Charts

Declaration

C#

public object DataSource { get; set; }

VB.NET

Public Property DataSource As Object

Property Value

Type	Description
Object	An object representing a series’ datasource.

Remarks

After the data source is assigned to the DataSource property, it is also required to provide appropriate values for the Series.ArgumentDataMember and Series.ValueDataMember properties.

Note that if the series’s data source implements the INotifyCollectionChanged interface, the Chart Control handles data source changes and updates the corresponding series. Call the ChartControl.UpdateData method to update data representation manually in other cases.

Example

The following example demonstrates how to bind a DXCharts control to an MDB database.

To accomplish this, it is necessary to add a corresponding DataSet to a project, and set the Series.ArgumentScaleType, Series.ArgumentDataMember, Series.ValueScaleType and Series.ValueDataMember properties to the required values.

Then, in a code-behind the Window.Initialize method, you can obtain all data from a DataSet, using the data adapter’s GetData method, and assign this data to a series’ Series.DataSource property.

Window1.xaml

<Window x:Class="WpfApplication1.Window1" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:dxc="http://schemas.devexpress.com/winfx/2008/xaml/charts" Title="Window1" Height="300" Width="396">
    <Grid>
        <dxc:ChartControl Name="chartControl1">
            <dxc:ChartControl.Diagram>
                <dxc:XYDiagram2D>
                    <dxc:XYDiagram2D.Series>
                        <dxc:BarSideBySideSeries2D Name="carSeries" ArgumentDataMember="Model" ValueDataMember="Price" />
                    </dxc:XYDiagram2D.Series>
                </dxc:XYDiagram2D>
            </dxc:ChartControl.Diagram>
        </dxc:ChartControl>
    </Grid>
</Window>

Window1.xaml.cs

using System.Windows;

namespace WpfApplication1 {

    public partial class Window1 : Window {
        public Window1() {
            InitializeComponent();

            carSeries.DataSource = 
                new CarsDBDataSetTableAdapters.CarsTableAdapter().GetData();
        }
    }
}

Window1.xaml.vb

Imports Microsoft.VisualBasic
Imports System.Windows

Namespace WpfApplication1

    Partial Public Class Window1
        Inherits Window
        Public Sub New()
            InitializeComponent()

            carSeries.DataSource = _
                New CarsDBDataSetTableAdapters.CarsTableAdapter().GetData()
        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

wpf-bind-a-range-control-to-a-chart-control/CS/GoldPrices/MainWindow.xaml#L71

DisplayName="Gold Price"
DataSource="{Binding}"
ArgumentDataMember="Date"

select-a-series-point-marker-based-on-a-point-argument/CS/MainWindow.xaml#L32

<dxc:LineSeries2D
    DataSource="{Binding DataItems, RelativeSource={RelativeSource AncestorType=Window, Mode=FindAncestor}}"
    MarkerVisible="True"

how-to-create-a-2d-side-by-side-bar-chart-e1257/CS/Window1.xaml#L17

<dxc:BarSideBySideSeries2D DisplayName="{Binding Name}"
                   DataSource="{Binding Values}"
                   ArgumentDataMember="Argument"

wpf-charts-create-real-time-chart/CS/RealtimeChartMVVM/MainWindow.xaml#L19

<dxc:SplineSeries2D DisplayName="Series 1"
                  DataSource="{Binding DataPoints}"
                  ArgumentDataMember="Argument"

wpf-chart-colorize-charts-with-the-color-object-colorizer/CS/ColorObjectColorizerExample/MainWindow.xaml#L17

<dxc:BarSideBySideSeries2D DisplayName="GDP"
                           DataSource="{Binding XPath=/G20HPIs/CountryStatistics}"
                           ArgumentDataMember="Country" ValueDataMember="Product"

C#

wpf-dashboard-how-to-obtain-clicked-item-data/CS/Dashboard_ClientDataCards_Wpf/MainWindow.xaml.cs#L79

{
    series.DataSource = dataSource; series.ArgumentDataMember = "Argument";
    series.ValueScaleType = ScaleType.Numerical;

VB.NET

wpf-dashboard-how-to-obtain-clicked-item-data/VB/Dashboard_ClientDataCards_Wpf/MainWindow.xaml.vb#L67

For Each series As Series In diagram.Series
    series.DataSource = dataSource
    series.ArgumentDataMember = "Argument"