[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Collapse]Charts Suite
   [Collapse]Chart Control
    [Expand]Getting Started
    [Expand]Fundamentals
    [Expand]Providing Data
    [Collapse]Chart Elements
     [Expand]Diagram
     [Collapse]Series
       Series Points
       Series Point Labels
      [Expand]Indicators
       Series Titles
       Total Labels
      Panes
     [Expand]Axes
      Legends
      Chart Titles
      Annotations
    [Expand]Appearance Customization
    [Expand]End-User Features
    [Expand]Design-Time Features
    [Expand]Examples
    [Expand]Additional Resources
   [Expand]Chart3D Control
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[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]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Series

A series is a group of data points that have the same argument and value types. A series type determines the number of values that are required to define a point, and it also specifies points' appearance. Series can also have additional series elements that help you analyze data and provide extra information. Series also allows you to filter data before displaying it in a chart.

The following image displays the Area, Line and Side-by-Side Bar series in a 2D XY Diagram:

This document consists of the following sections:

Expanded Creating Series

You can add series to a chart using one of the following approaches:

  • Create series manually

    The following example shows how to add an empty series to a chart:

    The table below lists classes and properties that allow you to add series to a chart manually:

    Member Description
    Diagram.Series The diagram series' collection. This is a content property. You can declare series in XAML directly after a diagram's declaration without wrapping them in opening and closing Diagram.Series tags.
    Series The base class for all individual series in the chart.
  • Create a series from a data source

    You can generate series based on a data source's column. This column also determines newly created series' display names.

    The markup above uses the following classes and properties:

    Member Description
    ChartControl.DataSource Gets or sets the chart control's data source.
    Diagram.SeriesTemplate Specifies the series template settings.
    Diagram.SeriesDataMember Gets or sets the name of the data field whose values are used to automatically generate and populate series.

Expanded Populating Series with Data

You need to populate a series with data after it is created. You can do this manually by adding each point to the series's points collection or filling the series with data from a data source automatically.

  • Manual adding points to a series

    In this approach, the series points' collection is populated with Series Points. Each point the chart visualizes should have an argument and values (their number can differ for different series).

    The following markup adds a Line series with five points:

    The markup above uses the following classes and properties:

    Member Description
    Series.Points The series's collection of points.
    SeriesPoint An individual point.
  • Populate a series with data from a data source

    In this case, you define data source's fields that provide points' arguments and values.

The following classes and properties are used in the example:

Member Description
Series.DataSource Specifies the series's data source.
Series.ArgumentDataMember Gets or sets the name of the data field which contains arguments for generated series points.
Series.ValueDataMember Gets or sets the name of the data field which contains values for generated series points.

Use additional DataMember properties if you are using a series that has several values per an argument. For example, use the BubbleSeries2D.WeightDataMember property to set the field that provides weights for Bubble Series points. The following table lists series that have specific ValueDataMember parameters:

Series

Parameters

Bubble

Series.ArgumentDataMember

Series.ValueDataMember

BubbleSeries2D.WeightDataMember

Stock

Candle Stick

Series.ArgumentDataMember

FinancialSeries2D.CloseValueDataMember

FinancialSeries2D.HighValueDataMember

FinancialSeries2D.LowValueDataMember

FinancialSeries2D.OpenValueDataMember

Side-by-Side Range Bar

Overlapped Range Bar

Series.ArgumentDataMember

Series.ValueDataMember

RangeBarSeries2D.Value2DataMember

Range Area

Series.ArgumentDataMember

Series.ValueDataMember

RangeAreaSeries2D.Value2DataMember

Range Polar Area

Range Radar Area

Series.ArgumentDataMember

Series.ValueDataMember

CircularRangeAreaSeries2D.Value2DataMember

Important

The series may provide points that represent data source values. These points are generated on the first series points getting. Do not request series points when the series is data bound due to performance reasons .

Refer to the Lesson 3 - Bind Chart Series to Data topic for a step-by-step guide on how to create a chart, bind it to a data source and populate its points with data.

Expanded MVVM Binding

When you are designing a charting application using the Model View ViewModel (MVVM) approach, use the Diagram.SeriesItemsSource property to bind a chart to a collection of objects containing series view models. Use Diagram.SeriesItemTemplate or Diagram.SeriesItemTemplateSelector to configure how the series view model is converted to a series on a chart.

Member Description
Diagram.SeriesItemsSource Gets or sets the collection of objects used to generate series.
Diagram.SeriesItemTemplate Gets or sets the System.Windows.DataTemplate that specifies how to convert a model object to a series.
Diagram.SeriesItemTemplateSelector Gets or sets the custom logic for selecting a data template that converts a model object to a series.

Examples:

Expanded Series Types

The Chart control provides 2D and 3D series. The following sections lists all available series:

Series of each type have unique specifics and settings. Ensure that series are compatible before plotting them in the same diagram. Refer to the Series Types Compatibility document to learn which series you can combine in one diagram.

Expanded Series Elements

Element

Image

Series Point Labels

You can show points with labels to provide extra information, such as point arguments or values.

Total Labels

Total labels display summary values of several Bar Stacked or Pie series' points.

Indicators

Indicators helps you to analyze and process series data visually.

Series Titles

A series title provides additional information on a series.

Expanded See Also

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