Back to all docs
API Reference / Telerik.Reporting.Charting / ChartSeries
New to Telerik Reporting? Start a free 30-day trial

ChartSeries

Class

Series

Definition

Constructors

ChartSeries()

Creates a new instance of ChartSeries class.

C#
public ChartSeries()

ChartSeries(ChartSeriesCollection)

Creates a new instance of ChartSeries class.

C#
public ChartSeries(ChartSeriesCollection parent)
Parameters:parentChartSeriesCollection

Parent of series

ChartSeries(string, ChartSeriesType, ChartSeriesCollection, ChartYAxisType, StyleSeries, string, string, string, string, string, string, string)

Creates a new instance of ChartSeries class.

C#
public ChartSeries(string seriesName, ChartSeriesType chartSeriesType, ChartSeriesCollection parent, ChartYAxisType yAxisType, StyleSeries style, string dataYColumn, string dataXColumn, string dataYColumn2, string dataXColumn2, string dataYColumn3, string dataYColumn4, string dataLabelsColumn)
Parameters:seriesNamestring

Name of series

chartSeriesTypeChartSeriesType

Type of series

parentChartSeriesCollection

Parent of series

yAxisTypeChartYAxisType

YAxisType(Primary or Secondary)

styleStyleSeries

Style of series

dataYColumnstring

DataSource column that is used to data-bind to the series YValue

dataXColumnstring

DataSource column that is used to data-bind to the series XValue

dataYColumn2string

DataSource column that is used to data-bind to the series YValue2

dataXColumn2string

DataSource column that is used to data-bind to the series XValue2

dataYColumn3string

DataSource column that is used to data-bind to the series YValue3

dataYColumn4string

DataSource column that is used to data-bind to the series YValue4

dataLabelsColumnstring

DataSource column (member) that will be used as ChartSeries names source when Y-values are taken from one column for a several chart ChartSeries

ChartSeries(string, ChartSeriesType, ChartSeriesCollection, ChartYAxisType, StyleSeries)

Creates a new instance of ChartSeries class.

C#
public ChartSeries(string seriesName, ChartSeriesType chartSeriesType, ChartSeriesCollection parent, ChartYAxisType yAxisType, StyleSeries style)
Parameters:seriesNamestring

Name of series

chartSeriesTypeChartSeriesType

Type of series

parentChartSeriesCollection

Parent of series

yAxisTypeChartYAxisType

YAxisType(Primary or Secondary)

styleStyleSeries

Style of series

ChartSeries(string, ChartSeriesType, ChartSeriesCollection)

Creates a new instance of ChartSeries class.

C#
public ChartSeries(string name, ChartSeriesType type, ChartSeriesCollection parent)
Parameters:namestring

Name of series

typeChartSeriesType

Type of series

parentChartSeriesCollection

Parent of series

ChartSeries(string, ChartSeriesType)

Creates a new instance of ChartSeries class with given name and type.

C#
public ChartSeries(string name, ChartSeriesType type)
Parameters:namestring

Name of series

typeChartSeriesType

Type of series

ChartSeries(string)

Creates a new instance of ChartSeries class with given name

C#
public ChartSeries(string name)
Parameters:namestring

Name of series

Properties

ActiveRegionAttributes

string

Default attributes for series items' active regions

C#
[PersistenceMode(PersistenceMode.Attribute)]
public string ActiveRegionAttributes { get; set; }

ActiveRegionToolTip

string

Default tooltip for series items' active regions

C#
[PersistenceMode(PersistenceMode.Attribute)]
public string ActiveRegionToolTip { get; set; }

ActiveRegionUrl

string

Default url for series items' active regions

C#
[PersistenceMode(PersistenceMode.Attribute)]
public string ActiveRegionUrl { get; set; }

Appearance

Specifies the visual appearance of series items.

C#
[TypeConverter(typeof(ExpandableObjectConverter))]
[Browsable(true)]
[PersistenceMode(PersistenceMode.InnerProperty)]
[SkinnableProperty]
public StyleSeries Appearance { get; }

DataLabelsColumn

string

Gets or sets the name of the DataSource column (member) that will be used as ChartSeries names source when Y-values are taken from one column for a several chart ChartSeries

C#
[PersistenceMode(PersistenceMode.Attribute)]
public string DataLabelsColumn { get; set; }

DataXColumn

string

Gets or sets the name of the DataSource column (member) that is used to data-bind to the series X-value

C#
[PersistenceMode(PersistenceMode.Attribute)]
public string DataXColumn { get; set; }

DataXColumn2

string

Gets or sets the name of the DataSource column (member) that is used to data-bind to the series X2-value

C#
[PersistenceMode(PersistenceMode.Attribute)]
public string DataXColumn2 { get; set; }

DataYColumn

string

Gets or sets the name of the DataSource column (member) that is used to data-bind to the series Y-value

C#
[PersistenceMode(PersistenceMode.Attribute)]
public string DataYColumn { get; set; }

DataYColumn2

string

Gets or sets the name of the DataSource column (member) that is used to data-bind to the series Y2-value

C#
[PersistenceMode(PersistenceMode.Attribute)]
public string DataYColumn2 { get; set; }

DataYColumn3

string

Gets or sets the name of the DataSource column (member) that is used to data-bind to the series Y3-value (High for CandleStick chart).

C#
[PersistenceMode(PersistenceMode.Attribute)]
public string DataYColumn3 { get; set; }

DataYColumn4

string

Gets or sets the name of the DataSource column (member) that is used to data-bind to the series Y4-value (Low for CandleStick chart).

C#
[PersistenceMode(PersistenceMode.Attribute)]
public string DataYColumn4 { get; set; }

DefaultLabelValue

string

Specifies the default value for the series items labels.

C#
[Browsable(true)]
public string DefaultLabelValue { get; set; }

Index

int

Current series index in the series collection

C#
[Bindable(false)]
[Browsable(false)]
public int Index { get; }

IsActiveRegionSet

bool

Returns whether there is an active region associated with the series.

C#
[Browsable(false)]
public bool IsActiveRegionSet { get; }

IsDataBound

bool

Determines whether the series is configured as data bound or not.

C#
[Browsable(false)]
public bool IsDataBound { get; }

Items

Gets a collection of series items.

C#
[PersistenceMode(PersistenceMode.InnerProperty)]
[SkinnableProperty]
public ChartSeriesItemsCollection Items { get; }

Name

string

Gets or sets the name of the data series.

C#
public string Name { get; set; }

Parent

Parent element

C#
[Browsable(false)]
public ChartSeriesCollection Parent { get; }

PlotArea

Plot area element for series drawing

C#
[Browsable(false)]
public ChartPlotArea PlotArea { get; }

this[int]

Gets or sets a ChartSeries SeriesItem object at the specified index.

C#
[Browsable(false)]
public ChartSeriesItem this[int itemIndex] { get; set; }
Parameters:itemIndexint

Type

Gets or sets the type of the series.

C#
public ChartSeriesType Type { get; set; }

Visible

bool

Specifies whether to render the series or not.

C#
public bool Visible { get; set; }

YAxisType

Y Axis used by series

C#
public ChartYAxisType YAxisType { get; set; }

Methods

AddItem(ChartSeriesItem, params ChartSeriesItem[])

Adds a series item(s) to the series.

C#
public void AddItem(ChartSeriesItem seriesItem, params ChartSeriesItem[] seriesItems)
Parameters:seriesItemChartSeriesItem

Item to add

seriesItemsChartSeriesItem[]

Items to add

AddItem(ChartSeriesItem[])

Adds a series item(s) to the series.

C#
public void AddItem(ChartSeriesItem[] seriesItems)
Parameters:seriesItemsChartSeriesItem[]

Items to add

AddItem(ChartSeriesItemsCollection)

Adds a series item(s) to the series.

C#
public void AddItem(ChartSeriesItemsCollection seriesItems)
Parameters:seriesItemsChartSeriesItemsCollection

Items to add

AddItem(double, string, Color, bool)

Adds a new series item to the data series by specifying its value, label, color and explosion.

C#
public void AddItem(double value, string label, Color color, bool exploded)
Parameters:valuedouble

YValue of new item

labelstring

Label of new item

colorColor

Color of new item

explodedbool

If item is exploded

AddItem(double, string, Color)

Adds a new series item to the data series by specifying its value, label and color.

C#
public void AddItem(double value, string label, Color color)
Parameters:valuedouble

YValue of new item

labelstring

Label of new item

colorColor

Color of new item

AddItem(double, string)

Adds a new series item to the data series by specifying its value and label.

C#
public void AddItem(double value, string label)
Parameters:valuedouble

YValue of new item

labelstring

Label of new item

AddItem(double)

Adds a new series item to the data series by specifying its value.

C#
public void AddItem(double value)
Parameters:valuedouble

YValue of new item

AddItem(List<ChartSeriesItem>)

Adds a series item(s) to the series.

C#
public void AddItem(List<ChartSeriesItem> seriesItems)
Parameters:seriesItemsList<ChartSeriesItem>

Items to add

Clear()

Clears all series items from the data series.

C#
public void Clear()

ClearDataBoundState()

Removes data binding links from series

C#
public void ClearDataBoundState()

CloneSeries()

Return new ChartSeries instance with copied all properties from source object and cloned Items collection

C#
public ChartSeries CloneSeries()
Returns:

ChartSeries

New instance of ChartSeries with copied fields

CopyFrom(ChartSeries)

Copies settings from given series

C#
protected void CopyFrom(ChartSeries originalSeries)
Parameters:originalSeriesChartSeries

Series to copy from

CopyItems(ChartSeries)

Copies series items from given series

C#
protected void CopyItems(ChartSeries originalSeries)
Parameters:originalSeriesChartSeries

Series that items should be copied

Dispose(bool)

Releases unmanaged and - optionally - managed resources

C#
protected override void Dispose(bool disposing)
Parameters:disposingbool

true to release both managed and unmanaged resources; false to release only unmanaged resources.

Overrides: StateManagedObject.Dispose(bool)

LoadViewState(object)

Load ViewState

C#
protected override void LoadViewState(object savedState)
Parameters:savedStateobject

ViewState with data

Overrides: StateManagedObject.LoadViewState(object)

RemoveItem(ChartSeriesItem, params ChartSeriesItem[])

Removes a series item(s) from the series.

C#
public void RemoveItem(ChartSeriesItem seriesItem, params ChartSeriesItem[] seriesItems)
Parameters:seriesItemChartSeriesItem

Item for removing

seriesItemsChartSeriesItem[]

Items for removing

RemoveItem(int, params int[])

Removes a series item(s) from the series.

C#
public void RemoveItem(int index, params int[] indexes)
Parameters:indexint

Index of item should be removed

indexesint[]

Indexes of items should be removed

RemoveItem(int)

Removes the SeriesItem object at the specified index.

C#
public void RemoveItem(int itemIndex)
Parameters:itemIndexint

Index to remove

SaveViewState()

object

Save Track ViewState

C#
protected override object SaveViewState()
Returns:

object

Object data as array

Overrides: StateManagedObject.SaveViewState()

SetColors(params Color[])

Sets new colors to the items in the data series.

C#
public void SetColors(params Color[] colors)
Parameters:colorsColor[]

New colors

SetExplodes(params bool[])

Sets exploded statuses to the items in the data series.

C#
public void SetExplodes(params bool[] explodes)
Parameters:explodesbool[]

New exploded values

SetItemColor(int, Color)

Sets a new color to the series item at the specified index.

C#
public void SetItemColor(int itemIndex, Color newColor)
Parameters:itemIndexint

Index of item to change color

newColorColor

New color of item

SetItemExplode(int, bool)

Sets a new explode status for the series item at the specified index.

C#
public void SetItemExplode(int itemIndex, bool exploded)
Parameters:itemIndexint

Index of item

explodedbool

Shoul be exploded or not

SetItemLabel(int, string)

Sets a new label for the series item at the specified index.

C#
public void SetItemLabel(int itemIndex, string newLabel)
Parameters:itemIndexint

Index of item to change label

newLabelstring

New label

SetItems(params ChartSeriesItem[])

Sets new SeriesItems objects to the data series.

C#
public void SetItems(params ChartSeriesItem[] seriesItems)
Parameters:seriesItemsChartSeriesItem[]

New Items to replace old items in series

SetItemValue(int, double)

Sets a new value for the series item at the specified index.

C#
public void SetItemValue(int itemIndex, double newValue)
Parameters:itemIndexint

Index of item to change YValue

newValuedouble

New YValue

SetLabels(params string[])

Sets new labels to the items in the data series.

C#
public void SetLabels(params string[] labels)
Parameters:labelsstring[]

New labels

SetValues(params double[])

Sets new values to the data series by passing an array of real values. Old values are cleared.

C#
public void SetValues(params double[] values)
Parameters:valuesdouble[]

New values

ToString()

string

Overridden

C#
public override string ToString()
Returns:

string

Series name

Overrides: StateManagedObject.ToString()

TrackViewState()

Track ViewState

C#
protected override void TrackViewState()

Overrides: StateManagedObject.TrackViewState()

In this article
DefinitionConstructorsChartSeries()ChartSeries(ChartSeriesCollection)ChartSeries(string)ChartSeries(string, ChartSeriesType)ChartSeries(string, ChartSeriesType, ChartSeriesCollection)ChartSeries(string, ChartSeriesType, ChartSeriesCollection, ChartYAxisType, StyleSeries)ChartSeries(string, ChartSeriesType, ChartSeriesCollection, ChartYAxisType, StyleSeries, string, string, string, string, string, string, string)PropertiesActiveRegionAttributesActiveRegionToolTipActiveRegionUrlAppearanceDataLabelsColumnDataXColumnDataXColumn2DataYColumnDataYColumn2DataYColumn3DataYColumn4DefaultLabelValueIndexIsActiveRegionSetIsDataBoundItemsNameParentPlotAreaTypeVisibleYAxisTypethis[int]MethodsAddItem(ChartSeriesItem, params ChartSeriesItem[])AddItem(ChartSeriesItem[])AddItem(ChartSeriesItemsCollection)AddItem(List<ChartSeriesItem>)AddItem(double)AddItem(double, string)AddItem(double, string, Color)AddItem(double, string, Color, bool)Clear()ClearDataBoundState()CloneSeries()CopyFrom(ChartSeries)CopyItems(ChartSeries)Dispose(bool)LoadViewState(object)RemoveItem(ChartSeriesItem, params ChartSeriesItem[])RemoveItem(int)RemoveItem(int, params int[])SaveViewState()SetColors(params Color[])SetExplodes(params bool[])SetItemColor(int, Color)SetItemExplode(int, bool)SetItemLabel(int, string)SetItemValue(int, double)SetItems(params ChartSeriesItem[])SetLabels(params string[])SetValues(params double[])ToString()TrackViewState()
Not finding the help you need?
Contact Support