Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Expand]Controls and Libraries
 [Expand]Common Features
  Get More Help
 [Collapse]API Reference
  [Expand]DevExpress.DataAccess.UI.Design
  [Expand]DevExpress.DataAccess.UI.EntityFramework
  [Expand]DevExpress.DataAccess.UI.Excel
  [Expand]DevExpress.DataAccess.UI.Localization
  [Expand]DevExpress.DataAccess.UI.ObjectBinding
  [Expand]DevExpress.DataAccess.UI.Sql
  [Expand]DevExpress.DataAccess.UI.Wizard
  [Expand]DevExpress.DataAccess.UI.Wizard.Services
  [Expand]DevExpress.DataAccess.UI.Wizard.Views
  [Expand]DevExpress.DocumentView
  [Expand]DevExpress.DocumentView.Controls
  [Expand]DevExpress.LookAndFeel
  [Expand]DevExpress.LookAndFeel.Helpers
  [Expand]DevExpress.Skins
  [Expand]DevExpress.Snap
  [Expand]DevExpress.Snap.API.Native
  [Expand]DevExpress.Snap.Core
  [Collapse]DevExpress.Snap.Core.API
   [Expand]AfterInsertSnListColumnsEventArgs Class
    AfterInsertSnListColumnsEventHandler Delegate
   [Expand]AfterInsertSnListDetailEventArgs Class
    AfterInsertSnListDetailEventHandler Delegate
   [Expand]AfterInsertSnListEventArgs Class
    AfterInsertSnListEventHandler Delegate
   [Expand]AfterInsertSnListRecordDataEventArgs Class
    AfterInsertSnListRecordDataEventHandler Delegate
   [Expand]BeforeInsertSnListColumnsEventArgs Class
    BeforeInsertSnListColumnsEventHandler Delegate
   [Expand]BeforeInsertSnListDetailEventArgs Class
    BeforeInsertSnListDetailEventHandler Delegate
   [Expand]BeforeInsertSnListEventArgs Class
    BeforeInsertSnListEventHandler Delegate
   [Expand]BeforeInsertSnListRecordDataEventArgs Class
    BeforeInsertSnListRecordDataEventHandler Delegate
   [Expand]CalculatedField Class
   [Expand]CalculatedFieldCollection Class
   [Expand]DataFieldInfo Class
   [Expand]DataSourceChangedEventArgs Class
    DataSourceChangedEventHandler Delegate
    DataSourceChangeType Enumeration
   [Expand]DataSourceInfo Class
   [Expand]DataSourceInfoCollection Class
    GroupInterval Enumeration
   [Expand]IDataSourceOwner Interface
   [Expand]ISnapFieldOwner Interface
   [Expand]Parameter Class
   [Expand]ParameterCollection Class
   [Expand]PrepareSnListColumnsEventArgs Class
    PrepareSnListColumnsEventHandler Delegate
   [Expand]PrepareSnListDetailEventArgs Class
    PrepareSnListDetailEventHandler Delegate
   [Expand]PrepareSnListEventArgs Class
    PrepareSnListEventHandler Delegate
   [Expand]SnapBarCode Interface
   [Collapse]SnapChart Interface
     SnapChart Members
    [Collapse]SnapChart Properties
      AnnotationRepository Property
      Annotations Property
      AppearanceName Property
      AppearanceRepository Property
      AutoLayout Property
      BackColor Property
      BackImage Property
      DataMember Property
      DataSource Property
      DataSourceName Property
      Diagram Property
      FillStyle Property
      Height Property
      ImageType Property
      IndicatorsPaletteName Property
      IndicatorsPaletteRepository Property
      Legend Property
      Legends Property
      PaletteBaseColorNumber Property
      PaletteName Property
      PaletteRepository Property
      Series Property
      SeriesDataMember Property
      SeriesNameTemplate Property
      SeriesSorting Property
      SeriesTemplate Property
      Size Property
      SmallChartText Property
      Titles Property
      UseExplicitSize Property
      Width Property
   [Expand]SnapCheckBox Interface
   [Expand]SnapDocument Interface
   [Expand]SnapDocumentFormat Class
   [Expand]SnapDocumentPosition Class
   [Expand]SnapDocumentRange Class
   [Expand]SnapEntity Interface
   [Expand]SnapHyperlink Interface
   [Expand]SnapImage Interface
   [Expand]SnapList Interface
   [Expand]SnapListFilters Interface
   [Expand]SnapListGroupInfo Interface
   [Expand]SnapListGroupParam Structure
   [Expand]SnapListGroups Interface
   [Expand]SnapListSorting Interface
   [Expand]SnapSingleListItemEntity Interface
   [Expand]SnapSparkline Interface
   [Expand]SnapSubDocument Interface
   [Expand]SnapText Interface
   [Expand]Theme Interface
   [Expand]ThemeCollection Interface
   [Expand]Themes Class
  [Expand]DevExpress.Snap.Core.Fields
  [Expand]DevExpress.Snap.Core.Forms
  [Expand]DevExpress.Snap.Core.Options
  [Expand]DevExpress.Snap.Core.Services
  [Expand]DevExpress.Snap.Extensions
  [Expand]DevExpress.Snap.Extensions.Localization
  [Expand]DevExpress.Snap.Extensions.UI
  [Expand]DevExpress.Snap.Localization
  [Expand]DevExpress.Snap.Options
  [Expand]DevExpress.Snap.Services
  [Expand]DevExpress.Utils
  [Expand]DevExpress.Utils.Animation
  [Expand]DevExpress.Utils.Controls
  [Expand]DevExpress.Utils.Drawing
  [Expand]DevExpress.Utils.Menu
  [Expand]DevExpress.Utils.Taskbar
  [Expand]DevExpress.Utils.Taskbar.Core
  [Expand]DevExpress.Utils.UI.Localization
  [Expand]DevExpress.Utils.VisualEffects
  [Expand]DevExpress.Utils.Win
  [Expand]DevExpress.XtraBars
  [Expand]DevExpress.XtraBars.Alerter
  [Expand]DevExpress.XtraBars.Docking
  [Expand]DevExpress.XtraBars.Docking2010
  [Expand]DevExpress.XtraBars.Docking2010.Customization
  [Expand]DevExpress.XtraBars.Docking2010.Views
  [Expand]DevExpress.XtraBars.Docking2010.Views.NativeMdi
  [Expand]DevExpress.XtraBars.Docking2010.Views.Tabbed
  [Expand]DevExpress.XtraBars.Docking2010.Views.Widget
  [Expand]DevExpress.XtraBars.Docking2010.Views.WindowsUI
  [Expand]DevExpress.XtraBars.Localization
  [Expand]DevExpress.XtraBars.Navigation
  [Expand]DevExpress.XtraBars.Ribbon
  [Expand]DevExpress.XtraBars.Ribbon.Gallery
  [Expand]DevExpress.XtraBars.Ribbon.ViewInfo
  [Expand]DevExpress.XtraBars.ToastNotifications
  [Expand]DevExpress.XtraBars.Utils
  [Expand]DevExpress.XtraBars.WinRTLiveTiles
  [Expand]DevExpress.XtraCharts
  [Expand]DevExpress.XtraCharts.Designer
  [Expand]DevExpress.XtraCharts.Wizard
  [Expand]DevExpress.XtraDataLayout
  [Expand]DevExpress.XtraDiagram
  [Expand]DevExpress.XtraDiagram.Options
  [Expand]DevExpress.XtraEditors
  [Expand]DevExpress.XtraEditors.ButtonPanel
  [Expand]DevExpress.XtraEditors.Calendar
  [Expand]DevExpress.XtraEditors.Camera
  [Expand]DevExpress.XtraEditors.Container
  [Expand]DevExpress.XtraEditors.Controls
  [Expand]DevExpress.XtraEditors.CustomEditor
  [Expand]DevExpress.XtraEditors.DXErrorProvider
  [Expand]DevExpress.XtraEditors.Filtering
  [Expand]DevExpress.XtraEditors.Mask
  [Expand]DevExpress.XtraEditors.Persistent
  [Expand]DevExpress.XtraEditors.Repository
  [Expand]DevExpress.XtraEditors.ViewInfo
  [Expand]DevExpress.XtraFilterEditor
  [Expand]DevExpress.XtraGauges.Presets.Styles
  [Expand]DevExpress.XtraGauges.Win
  [Expand]DevExpress.XtraGauges.Win.Base
  [Expand]DevExpress.XtraGauges.Win.Gauges.Circular
  [Expand]DevExpress.XtraGauges.Win.Gauges.Digital
  [Expand]DevExpress.XtraGauges.Win.Gauges.Linear
  [Expand]DevExpress.XtraGauges.Win.Gauges.State
  [Expand]DevExpress.XtraGrid
  [Expand]DevExpress.XtraGrid.Columns
  [Expand]DevExpress.XtraGrid.EditForm
  [Expand]DevExpress.XtraGrid.FilterEditor
  [Expand]DevExpress.XtraGrid.Localization
  [Expand]DevExpress.XtraGrid.Views.BandedGrid
  [Expand]DevExpress.XtraGrid.Views.BandedGrid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Base
  [Expand]DevExpress.XtraGrid.Views.Base.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Card
  [Expand]DevExpress.XtraGrid.Views.Card.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Grid
  [Expand]DevExpress.XtraGrid.Views.Grid.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Layout
  [Expand]DevExpress.XtraGrid.Views.Layout.Events
  [Expand]DevExpress.XtraGrid.Views.Layout.ViewInfo
  [Expand]DevExpress.XtraGrid.Views.Printing
  [Expand]DevExpress.XtraGrid.Views.Tile
  [Expand]DevExpress.XtraGrid.Views.WinExplorer
  [Expand]DevExpress.XtraGrid.WinExplorer
  [Expand]DevExpress.XtraLayout
  [Expand]DevExpress.XtraLayout.Customization
  [Expand]DevExpress.XtraLayout.HitInfo
  [Expand]DevExpress.XtraLayout.Localization
  [Expand]DevExpress.XtraLayout.Utils
  [Expand]DevExpress.XtraMap
  [Expand]DevExpress.XtraMap.Printing
  [Expand]DevExpress.XtraNavBar
  [Expand]DevExpress.XtraNavBar.ViewInfo
  [Expand]DevExpress.XtraPdfViewer
  [Expand]DevExpress.XtraPdfViewer.Commands
  [Expand]DevExpress.XtraPdfViewer.Localization
  [Expand]DevExpress.XtraPivotGrid
  [Expand]DevExpress.XtraPivotGrid.Data
  [Expand]DevExpress.XtraPrinting
  [Expand]DevExpress.XtraPrinting.Control
  [Expand]DevExpress.XtraPrinting.Preview
  [Expand]DevExpress.XtraPrintingLinks
  [Expand]DevExpress.XtraReports.UI
  [Expand]DevExpress.XtraRichEdit
  [Expand]DevExpress.XtraRichEdit.Commands
  [Expand]DevExpress.XtraRichEdit.Export
  [Expand]DevExpress.XtraRichEdit.Import
  [Expand]DevExpress.XtraRichEdit.Localization
  [Expand]DevExpress.XtraRichEdit.Menu
  [Expand]DevExpress.XtraScheduler
  [Expand]DevExpress.XtraScheduler.Drawing
  [Expand]DevExpress.XtraScheduler.Printing
  [Expand]DevExpress.XtraScheduler.Reporting
  [Expand]DevExpress.XtraScheduler.Reporting.UI
  [Expand]DevExpress.XtraScheduler.Services
  [Expand]DevExpress.XtraScheduler.Services.Implementation
  [Expand]DevExpress.XtraScheduler.UI
  [Expand]DevExpress.XtraSpellChecker
  [Expand]DevExpress.XtraSpellChecker.Localization
  [Expand]DevExpress.XtraSplashForm
  [Expand]DevExpress.XtraSplashScreen
  [Expand]DevExpress.XtraSpreadsheet
  [Expand]DevExpress.XtraSpreadsheet.Services
  [Expand]DevExpress.XtraTab
  [Expand]DevExpress.XtraTab.Buttons
  [Expand]DevExpress.XtraTab.ViewInfo
  [Expand]DevExpress.XtraTabbedMdi
  [Expand]DevExpress.XtraToolbox
  [Expand]DevExpress.XtraTreeList
  [Expand]DevExpress.XtraTreeList.Columns
  [Expand]DevExpress.XtraTreeList.Data
  [Expand]DevExpress.XtraTreeList.Localization
  [Expand]DevExpress.XtraTreeList.Menu
  [Expand]DevExpress.XtraTreeList.Nodes
  [Expand]DevExpress.XtraTreeList.Nodes.Operations
  [Expand]DevExpress.XtraTreeList.StyleFormatConditions
  [Expand]DevExpress.XtraTreeMap
  [Expand]DevExpress.XtraVerticalGrid
  [Expand]DevExpress.XtraVerticalGrid.Events
  [Expand]DevExpress.XtraVerticalGrid.Localization
  [Expand]DevExpress.XtraVerticalGrid.Rows
  [Expand]DevExpress.XtraWaitForm
  [Expand]DevExpress.XtraWizard
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

SnapChart.DataSource Property

Gets or sets the chart's data source.

Namespace:DevExpress.Snap.Core.API
Assembly:DevExpress.Snap.v17.2.Core.dll

Expanded Syntax

Property value

Type: Object
A System.Object representing the chart's data source.

Expanded Remarks

Use the DataSource property to specify the data source from which the current chart obtains information about its data series.

Note

If the chart's data source isn't set (the DataSource property is null), the default data source of the SnapDocument containing the chart is used.

There are two types of data binding available in a chart: you can bind each series separately (series binding) or the entire chart (chart binding) to data. In both cases, you first need to create a data source, and then assign it to the DataSource property.

If series binding is used (i.e., one or more series are added to the Series collection and both the DevExpress.XtraCharts.SeriesBase.ArgumentDataMember and DevExpress.XtraCharts.SeriesBase.ValueDataMembers properties of each series are set), you can specify different data sources for each series using a series' DevExpress.XtraCharts.Series.DataSource property. In this case, the DevExpress.XtraCharts.Series.DataSource property has a higher priority than the DataSource property of the chart.

Note that data binding performed at the chart level (chart binding) can force series objects to be created dynamically based on the common template settings. To do this, you should set the chart's DataSource and SeriesDataMember properties and assign the required data fields to the DevExpress.XtraCharts.SeriesBase.ArgumentDataMember and DevExpress.XtraCharts.SeriesBase.ValueDataMembers properties, accessible from the chart's SeriesTemplate property. The series objects obtained automatically from a data source specified in this way do not appear in the Series collection and can be customized using the SeriesTemplate settings.

Expanded Example

Show Me

A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=T569171.

Expanded See Also

How would you rate this topic?​​​​​​​