Series Series Series Series Class

Definition

Represents the data points and series attributes to store.

public ref class Series : System::Windows::Forms::DataVisualization::Charting::DataPointCustomProperties
public class Series : System.Windows.Forms.DataVisualization.Charting.DataPointCustomProperties
type Series = class
    inherit DataPointCustomProperties
Public Class Series
Inherits DataPointCustomProperties
Inheritance

Remarks

A Series object represents a data series and is stored in the SeriesCollection class.

A Series stores DataPoint objects using the DataPointCollection class. It also stores attributes of the data series. For example, a data series has a color attribute, background image attribute, background gradient attribute, and so forth.

The DataPoint objects that belong to a series also have their own attributes. Normally, if the same attribute is set for a data point and the series to which it belongs, the data point attribute has precedence.

A series is not necessarily plotted on a chart; it can store data point values that are used to perform a calculation from which another series is created and then plotted. For example, Series A, which is plotted, may be the result of adding Series B and Series C data points together, though neither of these series is plotted. In order to draw a Series object, the ChartArea property must be set to the name of the ChartArea object used to plot the series.

When a series is created, it is automatically assigned to the ChartArea object named "Default", or to the first available chart area in the chart area collection if the "Default" object does not exist.

To disable the display of a series, set its ChartArea property to a zero-length string.

The ChartType property determines the type of chart that will be used to plot this series, if it is drawn.

Constructors

Series() Series() Series() Series()

Initializes a new instance of the Series class.

Series(String) Series(String) Series(String) Series(String)

Initializes a new instance of the Series class with the specified series name.

Series(String, Int32) Series(String, Int32) Series(String, Int32) Series(String, Int32)

Initializes a new instance of the Series class with the specified name and maximum number of Y-values.

Properties

AxisLabel AxisLabel AxisLabel AxisLabel

Gets or sets the axis label text for the series.

BackGradientStyle BackGradientStyle BackGradientStyle BackGradientStyle

Gets or sets the background gradient style.

(Inherited from DataPointCustomProperties)
BackHatchStyle BackHatchStyle BackHatchStyle BackHatchStyle

Gets or sets the background hatching style.

(Inherited from DataPointCustomProperties)
BackImage BackImage BackImage BackImage

Gets or sets the background image of the data point.

(Inherited from DataPointCustomProperties)
BackImageAlignment BackImageAlignment BackImageAlignment BackImageAlignment

Gets or sets the alignment of the background image, which is used with the Unscaled drawing mode.

(Inherited from DataPointCustomProperties)
BackImageTransparentColor BackImageTransparentColor BackImageTransparentColor BackImageTransparentColor

Gets or sets a color that will be replaced with a transparent color when the background image is drawn.

(Inherited from DataPointCustomProperties)
BackImageWrapMode BackImageWrapMode BackImageWrapMode BackImageWrapMode

Gets or sets the drawing mode of the background image.

(Inherited from DataPointCustomProperties)
BackSecondaryColor BackSecondaryColor BackSecondaryColor BackSecondaryColor

Gets or sets the secondary background color.

(Inherited from DataPointCustomProperties)
BorderColor BorderColor BorderColor BorderColor

Gets or sets the border color of the data point.

(Inherited from DataPointCustomProperties)
BorderDashStyle BorderDashStyle BorderDashStyle BorderDashStyle

Gets or sets the border style of the data point.

(Inherited from DataPointCustomProperties)
BorderWidth BorderWidth BorderWidth BorderWidth

Gets or sets the border width of the data point.

(Inherited from DataPointCustomProperties)
ChartArea ChartArea ChartArea ChartArea

Gets or sets the name of the ChartArea object used to plot the data series, if any.

ChartType ChartType ChartType ChartType

Gets or sets the chart type of a series.

ChartTypeName ChartTypeName ChartTypeName ChartTypeName

Gets or sets the name of the chart type used to draw the series.

Color Color Color Color

Gets or sets the color of the data point.

(Inherited from DataPointCustomProperties)
CustomProperties CustomProperties CustomProperties CustomProperties

Gets or sets the custom properties of the data point. Custom properties can be specified in the following format: AttrName1=Value1, AttrName2=Value2 …

(Inherited from DataPointCustomProperties)
CustomPropertiesExtended CustomPropertiesExtended CustomPropertiesExtended CustomPropertiesExtended

Gets or sets the extended custom properties of the data point. Extended custom properties can be specified in the following format: AttrName1=Value1, AttrName2=Value2...

(Inherited from DataPointCustomProperties)
EmptyPointStyle EmptyPointStyle EmptyPointStyle EmptyPointStyle

Gets or sets the drawing style of points marked as empty.

Enabled Enabled Enabled Enabled

Gets or sets a flag that indicates whether the series will be visible on the rendered chart.

Font Font Font Font

Gets or sets the font of the data point.

(Inherited from DataPointCustomProperties)
IsValueShownAsLabel IsValueShownAsLabel IsValueShownAsLabel IsValueShownAsLabel

Gets or sets a flag that indicates whether to show the value of the data point on the label.

(Inherited from DataPointCustomProperties)
IsVisibleInLegend IsVisibleInLegend IsVisibleInLegend IsVisibleInLegend

Gets or sets a flag that indicates whether the item is shown in the legend.

(Inherited from DataPointCustomProperties)
IsXValueIndexed IsXValueIndexed IsXValueIndexed IsXValueIndexed

Gets or sets a flag that indicates whether data point indices will be used for the X-values.

Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Gets the DataPointCustomProperties object by its position in the index.

(Inherited from DataPointCustomProperties)
Item[String] Item[String] Item[String] Item[String]

Gets or sets the DataPointCustomProperties object by name.

(Inherited from DataPointCustomProperties)
Label Label Label Label

Gets or sets the text of the data point label.

(Inherited from DataPointCustomProperties)
LabelAngle LabelAngle LabelAngle LabelAngle

Gets or sets the angle of the data point label.

(Inherited from DataPointCustomProperties)
LabelBackColor LabelBackColor LabelBackColor LabelBackColor

Gets or sets the background color of the data point label.

(Inherited from DataPointCustomProperties)
LabelBorderColor LabelBorderColor LabelBorderColor LabelBorderColor

Gets or sets the border color of the data point label.

(Inherited from DataPointCustomProperties)
LabelBorderDashStyle LabelBorderDashStyle LabelBorderDashStyle LabelBorderDashStyle

Gets or sets the border style of the label.

(Inherited from DataPointCustomProperties)
LabelBorderWidth LabelBorderWidth LabelBorderWidth LabelBorderWidth

Gets or sets the border width of the label.

(Inherited from DataPointCustomProperties)
LabelForeColor LabelForeColor LabelForeColor LabelForeColor

Gets or sets the text color of the label.

(Inherited from DataPointCustomProperties)
LabelFormat LabelFormat LabelFormat LabelFormat

Gets or sets the format of the data point label.

(Inherited from DataPointCustomProperties)
LabelToolTip LabelToolTip LabelToolTip LabelToolTip

Gets or sets the tooltip for the data point label.

(Inherited from DataPointCustomProperties)
Legend Legend Legend Legend

Gets or sets the name of the series associated with the Legend object.

LegendText LegendText LegendText LegendText

Gets or sets the text of the item in the legend.

(Inherited from DataPointCustomProperties)
LegendToolTip LegendToolTip LegendToolTip LegendToolTip

Gets or sets the tooltip of the item in the legend.

(Inherited from DataPointCustomProperties)
MarkerBorderColor MarkerBorderColor MarkerBorderColor MarkerBorderColor

Gets or sets the border color of the marker.

(Inherited from DataPointCustomProperties)
MarkerBorderWidth MarkerBorderWidth MarkerBorderWidth MarkerBorderWidth

Gets or sets the border width of the marker.

(Inherited from DataPointCustomProperties)
MarkerColor MarkerColor MarkerColor MarkerColor

Gets or sets the marker color.

(Inherited from DataPointCustomProperties)
MarkerImage MarkerImage MarkerImage MarkerImage

Gets or sets the marker image.

(Inherited from DataPointCustomProperties)
MarkerImageTransparentColor MarkerImageTransparentColor MarkerImageTransparentColor MarkerImageTransparentColor

Gets or sets the color that will be replaced with a transparent color when the marker image is drawn.

(Inherited from DataPointCustomProperties)
MarkerSize MarkerSize MarkerSize MarkerSize

Gets or sets the size of the marker.

(Inherited from DataPointCustomProperties)
MarkerStep MarkerStep MarkerStep MarkerStep

Gets or sets a value that determines how often to display data point markers.

MarkerStyle MarkerStyle MarkerStyle MarkerStyle

Gets or sets the marker style.

(Inherited from DataPointCustomProperties)
Name Name Name Name

Gets or sets the unique name of a Series object.

Palette Palette Palette Palette

Gets or sets the color palette of a Series object.

Points Points Points Points

Gets a collection of data points.

ShadowColor ShadowColor ShadowColor ShadowColor

Gets or sets the shadow color of a series.

ShadowOffset ShadowOffset ShadowOffset ShadowOffset

Gets or sets the shadow offset, in pixels, of a series.

SmartLabelStyle SmartLabelStyle SmartLabelStyle SmartLabelStyle

Gets or sets the style of the smart labels.

Tag Tag Tag Tag

Gets or sets an object associated with this chart element.

(Inherited from ChartElement)
ToolTip ToolTip ToolTip ToolTip

Gets or sets the tooltip.

(Inherited from DataPointCustomProperties)
XAxisType XAxisType XAxisType XAxisType

Gets or sets the X-axis type of the series.

XValueMember XValueMember XValueMember XValueMember

Gets or sets the member of the chart data source used to data bind to the X-value of the series.

XValueType XValueType XValueType XValueType

Gets or sets the value types plotted along the X-axis.

YAxisType YAxisType YAxisType YAxisType

Gets or sets the Y-axis type of a series.

YValueMembers YValueMembers YValueMembers YValueMembers

Gets or sets member columns of the chart data source used to bind data to the Y-values of the series.

YValuesPerPoint YValuesPerPoint YValuesPerPoint YValuesPerPoint

Gets or sets the maximum number of Y-values that DataPoint objects in a Series are allowed to have.

YValueType YValueType YValueType YValueType

Gets or sets the type of Y-value data in the data points stored by a series.

Methods

DeleteCustomProperty(String) DeleteCustomProperty(String) DeleteCustomProperty(String) DeleteCustomProperty(String)

Deletes the data point custom property with the specified name.

(Inherited from DataPointCustomProperties)
Dispose() Dispose() Dispose() Dispose()

Releases the resources used by the ChartElement.

(Inherited from ChartElement)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Releases the unmanaged resources used by the Series and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determines whether the specified Object is equal to the current ChartElement.

(Inherited from ChartElement)
GetCustomProperty(String) GetCustomProperty(String) GetCustomProperty(String) GetCustomProperty(String)

Returns the data point custom property with the specified name.

(Inherited from DataPointCustomProperties)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Returns a hash function for a particular type.

(Inherited from ChartElement)
GetType() GetType() GetType() GetType()

Gets the Type of the current instance.

(Inherited from Object)
IsCustomPropertySet(String) IsCustomPropertySet(String) IsCustomPropertySet(String) IsCustomPropertySet(String)

Determines whether a custom property with the specified name was set.

(Inherited from DataPointCustomProperties)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ResetIsValueShownAsLabel() ResetIsValueShownAsLabel() ResetIsValueShownAsLabel() ResetIsValueShownAsLabel()

Resets a custom property to its default value.

(Inherited from DataPointCustomProperties)
ResetIsVisibleInLegend() ResetIsVisibleInLegend() ResetIsVisibleInLegend() ResetIsVisibleInLegend()

Resets a custom property to its default value.

(Inherited from DataPointCustomProperties)
SetCustomProperty(String, String) SetCustomProperty(String, String) SetCustomProperty(String, String) SetCustomProperty(String, String)

Sets a custom property of the data point.

(Inherited from DataPointCustomProperties)
SetDefault(Boolean) SetDefault(Boolean) SetDefault(Boolean) SetDefault(Boolean)

Sets the default properties of the data point. Indicates whether the previous property values must be cleared.

(Inherited from DataPointCustomProperties)
Sort(IComparer<DataPoint>) Sort(IComparer<DataPoint>) Sort(IComparer<DataPoint>) Sort(IComparer<DataPoint>)

Sorts the points in the series using IComparer interface.

Sort(PointSortOrder) Sort(PointSortOrder) Sort(PointSortOrder) Sort(PointSortOrder)

Sorts the data points in the series, given the specified sort order.

Sort(PointSortOrder, String) Sort(PointSortOrder, String) Sort(PointSortOrder, String) Sort(PointSortOrder, String)

Sorts the points in the series, given the specified sort order and value to use for the sort.

ToString() ToString() ToString() ToString()

Returns a string that represents the current Object.

(Inherited from ChartElement)

Applies to