[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Collapse]Chart Control
   [Expand]Getting Started
   [Collapse]Fundamentals
    [Expand]Charting Basics
    [Expand]Professional Charting
    [Expand]Series Views
    [Collapse]Chart Elements
     [Collapse]Series
      [Expand]Indicators
       Series Points
       Series Point Labels
       Total Labels
       Series Titles
     [Expand]Diagram
      Chart Titles
     [Expand]Legends
     [Expand]Annotations
   [Expand]Providing Data
   [Expand]Appearance Customization
   [Expand]End-User Features
   [Expand]Design-Time Features
   [Expand]Visual Elements
   [Expand]Examples
   [Expand]Additional Resources
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[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]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Series

The Series is the chart element that represents data within the Chart Control. The series's view specifies the data's appearance. The Series's elements (Series Labels, Series Titles and others) display additional information about series' data. For example, The Series Titles show series names and allow end-users to identify the pie series within the Chart Control. The Series also provides a filtering and sorting functionality to filter and sort data before visualization.

This topic consists of the following sections:

Expanded Series Creation

Use one of the following approaches to add a series to the chart:

  • Create a series manually

    The following code adds a manually created series with no data to the chart:

    Next, fill a series with data using one of the ways described in the Data Providing section.

    The code above uses the below classes and members:

    SymbolDescription
    Series Represents an individual series within a chart control.
    ChartControl.Series Provides access to the chart control's collection of series objects.

    Refer to the Create a Series Manually topic to learn how to add a series at design time.

  • Create series from a data source

    In this approach, the chart generates series from its data source:

    The previous code snippet contains the following classes and members:

    SymbolDescription
    ChartControl.DataSource Gets or sets the chart control's data source.
    ChartControl.SeriesTemplate Returns the series template the chart uses to generate its series.
    SeriesTemplate.SeriesDataMember Gets or sets the name of the data member whose values identify series.

    Refer to the Data Providing: Getting data from a data source section for more information about argument and value data members. See the Generate Series from a Data Source document for more information about series templates.

Expanded Individual Series Accessing

Each chart can contain an unlimited number of series. You can click on a series to access it at design time .

Use the following code to get access to an individual series at runtime:

The following table lists the properties used the code above:

Symbol Description
ChartControl.Series Provides access to the chart control's collection of series objects.
SeriesCollection.Item Provides access to individual items that the collection stores.
Series.Name Gets or sets the name of the series.

Expanded Data Providing

The series obtains the data it visualize in the following ways:

  • Manually adding points to a series

    In this approach, the series point objects that the series stores represent the argument-value set that a series should visualize. The following code demonstrates how to populate a series with series points:

    The code above uses the following classes and properties:

    SymbolDescription
    Series.Points Gets the series' collection of data points.
    SeriesPoint Represents an individual series point.

    Note that series points can be created at design time. The series's Points collection provides helper methods that simplify adding points with several values at runtime. Refer to the Manually Add Points to a Series topic to learn more about these features.

  • Getting data from a data source

    This means that the series's data source provides its data row field values to the series as argument and values. The SeriesBase.ArgumentDataMember and SeriesBase.ValueDataMembers properties specify which data source values should be used. The code below demonstrates how to use this approach:

    The previous code uses the following classes and members:

    Symbol Description
    Series.DataSource Gets or sets the series' data source.
    SeriesBase.ArgumentDataMember Gets or sets the name of the data field that contains series point arguments.
    SeriesBase.ValueDataMembers Gets a collection of the names of data fields that contain series point values.
    SeriesBase.SetDataMembers Specifies the data members whose values the series uses to populate series points' arguments and values.
    Important

    The series may provide points that represent data source values. These points are generated on the first series points getting. Due to performance reasons, it is strongly recommended not to request series points when the series is data bound.

    Refer to the Specify Series Data Members section for more information about design-time customization and helper methods.

Expanded Series View Changing

To change the series view at design time, select the series, locate the SeriesBase.View property in the Properties window and click the ellipsis button. In the invoked dialog window, select the series view and click OK.

Use the below code to change the series view at runtime:

The code above uses the following classes and properties:

Symbol Description
SeriesBase.View Gets or sets the view that the series uses to visualize its data.
SeriesViewBase Represents the base class for all series view objects.
Important

Series that the chart displays should have compatible series views. For example, the pie series view is not compatible with the area series view, and a chart cannot show these series simultaneously. In this case, the chart draws the first series in the collection.

Expanded Series Elements Customization

The following series elements that display additional information about series' data are customizable:

Element and Description Sample Image

Series Point Labels

Text labels that represent point's values, for example arguments or values in percent.

Total Labels

Total Labels show Stacked Bar series groups' summary values or all pie points' summary value.

Series Titles

The Series Title accompanies a series and usually displays the series name. The Series Titles are designed to allow end-users to distinguish several series that the chart displays simultaneously and are available only for series that use the Pie, Doughnut or Funnel series view.

Indicators

Indicators allow you to perform visual data analysis using the 2D XY-series data's.

Is this topic helpful?​​​​​​​