Version

Range Series

This topic explains various types of Range Series in the UltraDataChart™ control.

Introduction

Range Series is a group of the simplest and most common form of chart series that take data and render it as collection of data points stretched along a horizontal line (e.g. column series) or vertical line (e.g. bar series).

Types of Range Series

The UltraDataChart control supports the following types of Range Series and each of them is discussed in an individual topic:

These topics will provide you with useful information on how to use create a specific type of Range Series and bind data to it.

Preview of Range Series

This section provides preview images for all types of Range Series.

Using xamDataChart Category Series 11.png

Figure 1: Sample implementation of Range Column Series

Using xamDataChart Category Series 12.png

Figure 2: Sample implementation of Range Area Series

Supported Axes

The UltraDataChart control provides various types of axes but only the following types of axes can be used with specific types of Range Series. The following table lists these supported axes:

Series Type XAxis Type YAxis Type

RangeColumnSeries

RangeAreaSeries

In addition, each of Range Series must have binding set to one x-axis using the property XAxis and one y-axis using YAxis property. For more information on axes, refer to the Axes topic.

Data Binding

This section provides information about binding data for all types of Range Series from data requirements through data sample to binding diagrams.

Data Requirements

Similarly to other types of series in the UltraDataChart control, Range Series also use DataSource property to bind data. The following is a list of data requirements for Range Series:

  • The data model should contain one data column (string or date time) which is mapped to the Label property of the category axis (e.g. CategoryXAxis) or the DateTimeMemberPath when using TimeXAxis.

  • The data model must contain one numeric data column which is mapped using the HighMemberPath property of range series

  • The data model must contain second numeric data column which is mapped using the LowMemberPath property of range series

  • The data source must contain at least one data items otherwise the chart will not render the range series.

  • The data source must implement the IEnumerable interface (e.g. List, Collection, Queue, or Stack)

For more information on the requirements for the specific types of series, refer to the Series Requirements topic.

Data Sample

An example of object that meets above criteria is the Sample Energy Data which you can download and use it in your project.