[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
   [Expand]Chart Control
   [Collapse]Chart3D Control
    [Expand]Getting Started
    [Collapse]Series
      Provide Series Data
      Customize Series Appearance
     Legends
     Axes
     Titles
     Interactivity
  [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]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

Provide Series Data

The Chart3DControl can display data specified by one or more series, each series bound to a set of points in three dimensions. When creating a chart, start with series, and then provide data for them.

This document describes how to provide the Chart3D control with data.

Expanded Create Series Automatically from a Template

Use the following XAML to create several series from a data source:

The code above uses the following classes and properties:

Property or Class Description
Chart3DControl.SeriesSource The Chart3D control's series source. (Content property)
Series3DDataSourceAdapter Generates series from a data source.
Series3DDataSourceAdapter.SeriesTemplate The series template.

Note that automatically generated series can be fine-tuned using the Series3DDataSourceAdapter.CustomizeSeries event.

Expanded Create Series Manually

The following XAML can be utilized to provide the series to the Chart3D control manually:

The code snippet above uses the following classes and members:

Class or Property Description
Chart3DControl.SeriesSource The series source of the Chart3D control. (Content property)
Series3DStorage The manually created series' storage.
Series3D An individual series.

Expanded Create a Series Manually with Unbound Point Data

The series storage allows you to create and configure series points manually if you do not have a data source of arguments and values. The following XAML demonstrates this method:

The following properties and classes are used in the snippets above:

Class or Property Description
Series3D.PointSource The source of series' points. (Content property)
SeriesPoint3DStorage The storage of manually created points.
SeriesPoint3DStorage.Points The collection of manually created points. (Content property)
SeriesPoint3D An individual series point.
SeriesPoint3D.XArgument The X-argument value of the individual series point.
SeriesPoint3D.YArgument The Y-argument value of the individual series point.
SeriesPoint3D.Value The value of the individual series point.

Expanded Create Series Manually with Points from a Data Source

Use the following XAML to populate a series with points generated from an external source:

The code snippet above uses the following properties and classes:

Class or Property Description
Series3D.PointSource The source of series' points. (Content property)
SeriesPoint3DDataSourceAdapter Generates series points based on the specified data source's values.
SeriesPoint3DDataSourceAdapter.DataSource The source whose values are used to generate series points.
SeriesPoint3DDataSourceAdapter.XArgumentDataMember The name of the data member whose values are used as X-arguments of points.
SeriesPoint3DDataSourceAdapter.YArgumentDataMember The name of the data member whose values are used as Y-arguments of points.
SeriesPoint3DDataSourceAdapter.ValueDataMember The name of the data member whose values are used as values of points.

Expanded Create Series Manually with Points from Arguments and Value Arrays

Use the following approach to provide data using arrays of X- and Y-arguments and values:

The code snippet above uses the following properties and classes:

Class or Property Description
Series3D.PointSource The source of series' points. (Content property)
SeriesPoint3DMatrixAdapter Creates series points by the specified arguments and values.
SeriesPoint3DMatrixAdapter.XArguments The X argument values.
SeriesPoint3DMatrixAdapter.YArguments The Y argument values.
SeriesPoint3DMatrixAdapter.Values The values.

The points are formed using the following principles: for each X argument value, all Y argument values and the required number (the Y arguments count) of values are selected from collections. Use the SeriesPoint3DMatrixAdapter.IsCorrectDimension property to check whether the value collection contains the required number of values to plot the grid.

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