Series Class

Definition

Represents the data points and series attributes to store.

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

Initializes a new instance of the Series class.

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

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

Properties

Gets or sets the axis label text for the series.

Gets or sets the background gradient style.

(Inherited from DataPointCustomProperties) BackHatchStyle

Gets or sets the background hatching style.

(Inherited from DataPointCustomProperties) BackImage

Gets or sets the background image of the data point.

(Inherited from DataPointCustomProperties) BackImageAlignment

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

(Inherited from DataPointCustomProperties) BackImageTransparentColor

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

(Inherited from DataPointCustomProperties) BackImageWrapMode

Gets or sets the drawing mode of the background image.

(Inherited from DataPointCustomProperties) BackSecondaryColor

Gets or sets the secondary background color.

(Inherited from DataPointCustomProperties) BorderColor

Gets or sets the border color of the data point.

(Inherited from DataPointCustomProperties) BorderDashStyle

Gets or sets the border style of the data point.

(Inherited from DataPointCustomProperties) BorderWidth

Gets or sets the border width of the data point.

(Inherited from DataPointCustomProperties) ChartArea

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

Gets or sets the chart type of a series.

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

Gets or sets the color of the data point.

(Inherited from DataPointCustomProperties) 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

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

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

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

Gets or sets the font of the data point.

(Inherited from DataPointCustomProperties) IsValueShownAsLabel

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

(Inherited from DataPointCustomProperties) IsVisibleInLegend

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

(Inherited from DataPointCustomProperties) IsXValueIndexed

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

Gets the DataPointCustomProperties object by its position in the index.

(Inherited from DataPointCustomProperties) Item[String]

Gets or sets the DataPointCustomProperties object by name.

(Inherited from DataPointCustomProperties) Label

Gets or sets the text of the data point label.

(Inherited from DataPointCustomProperties) LabelAngle

Gets or sets the angle of the data point label.

(Inherited from DataPointCustomProperties) LabelBackColor

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

(Inherited from DataPointCustomProperties) LabelBorderColor

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

(Inherited from DataPointCustomProperties) LabelBorderDashStyle

Gets or sets the border style of the label.

(Inherited from DataPointCustomProperties) LabelBorderWidth

Gets or sets the border width of the label.

(Inherited from DataPointCustomProperties) LabelForeColor

Gets or sets the text color of the label.

(Inherited from DataPointCustomProperties) LabelFormat

Gets or sets the format of the data point label.

(Inherited from DataPointCustomProperties) LabelToolTip

Gets or sets the tooltip for the data point label.

(Inherited from DataPointCustomProperties) Legend

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

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

(Inherited from DataPointCustomProperties) LegendToolTip

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

(Inherited from DataPointCustomProperties) MarkerBorderColor

Gets or sets the border color of the marker.

(Inherited from DataPointCustomProperties)

MarkerBorderWidth

Gets or sets the border width of the marker.

(Inherited from DataPointCustomProperties) MarkerColor

Gets or sets the marker color.

(Inherited from DataPointCustomProperties) MarkerImage

Gets or sets the marker image.

(Inherited from DataPointCustomProperties) MarkerImageTransparentColor

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

(Inherited from DataPointCustomProperties) MarkerSize

Gets or sets the size of the marker.

(Inherited from DataPointCustomProperties) MarkerStep

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

Gets or sets the marker style.

(Inherited from DataPointCustomProperties) Name

Gets or sets the unique name of a Series object.

Gets or sets the color palette of a Series object.

Gets a collection of data points.

Gets or sets the shadow color of a series.

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

Gets or sets the style of the smart labels.

Gets or sets an object associated with this chart element.

(Inherited from ChartElement) ToolTip

Gets or sets the tooltip.

(Inherited from DataPointCustomProperties) XAxisType

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

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

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

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

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

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

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

Methods

Deletes the data point custom property with the specified name.

(Inherited from DataPointCustomProperties) Dispose()

Releases the resources used by the ChartElement.

(Inherited from ChartElement) Dispose(Boolean)

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

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

(Inherited from ChartElement) GetCustomProperty(String)

Returns the data point custom property with the specified name.

(Inherited from DataPointCustomProperties) GetHashCode()

Returns a hash function for a particular type.

(Inherited from ChartElement) GetType()

Gets the Type of the current instance.

(Inherited from Object) IsCustomPropertySet(String)

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

(Inherited from DataPointCustomProperties) MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object) ResetIsValueShownAsLabel()

Resets a custom property to its default value.

(Inherited from DataPointCustomProperties) ResetIsVisibleInLegend()

Resets a custom property to its default value.

(Inherited from DataPointCustomProperties) SetCustomProperty(String, String)

Sets a custom property of the data point.

(Inherited from DataPointCustomProperties) SetDefault(Boolean)

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

(Inherited from DataPointCustomProperties) Sort(IComparer )

Sorts the points in the series using IComparer interface.

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

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

Returns a string that represents the current Object.

Series Класс

Определение

Представляет точку данных и атрибуты серии для хранения. Represents the data points and series attributes to store.

Комментарии

SeriesОбъект представляет ряд данных и хранится в SeriesCollection классе. A Series object represents a data series and is stored in the SeriesCollection class.

Объект Series хранит DataPoint объекты с помощью DataPointCollection класса. A Series stores DataPoint objects using the DataPointCollection class. Он также хранит атрибуты ряда данных. It also stores attributes of the data series. Например, ряд данных имеет атрибут Color, атрибут фонового изображения, атрибут фонового градиента и т. д. For example, a data series has a color attribute, background image attribute, background gradient attribute, and so forth.

DataPointОбъекты, принадлежащие к ряду, также имеют собственные атрибуты. 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. Например, ряды A, которые отображаются на диаграмме, могут быть результатом сложения точек данных серии B и C, хотя ни один из этих рядов не построен. 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. Чтобы нарисовать Series объект, ChartArea свойству должно быть присвоено имя ChartArea объекта, используемого для построения ряда. 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.

При создании ряда он автоматически назначается ChartArea объекту с именем «default» или первой доступной области диаграммы в коллекции областей диаграммы, если объект «default» не существует. 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.

Чтобы отключить отображение ряда, задайте ChartArea для его свойства строку нулевой длины. To disable the display of a series, set its ChartArea property to a zero-length string.

ChartTypeСвойство определяет тип диаграммы, которая будет использоваться для построения этого ряда при его прорисовке. The ChartType property determines the type of chart that will be used to plot this series, if it is drawn.

Конструкторы

Инициализирует новый экземпляр класса Series. Initializes a new instance of the Series class.

Инициализирует новый экземпляр класса Series указанным именем ряда. Initializes a new instance of the Series class with the specified series name.

Инициализирует новый экземпляр класса Series с указанным именем и максимальным числом значений Y. Initializes a new instance of the Series class with the specified name and maximum number of Y-values.

Свойства

Получает или задает текстовую подпись оси для ряда. Gets or sets the axis label text for the series.

Получает или задает стиль градиента фона. Gets or sets the background gradient style.

(Унаследовано от DataPointCustomProperties) BackHatchStyle

Получает или задает стиль штриховки фона. Gets or sets the background hatching style.

(Унаследовано от DataPointCustomProperties) BackImage

Получает или задает фоновое изображение для точки данных. Gets or sets the background image of the data point.

(Унаследовано от DataPointCustomProperties) BackImageAlignment

Получает или задает тип выравнивания фонового изображения, используемого вместе с режимом рисования Unscaled. Gets or sets the alignment of the background image, which is used with the Unscaled drawing mode.

(Унаследовано от DataPointCustomProperties) BackImageTransparentColor

Получает или задает цвет, который будет заменен прозрачным цветом при рисовании фонового изображения. Gets or sets a color that will be replaced with a transparent color when the background image is drawn.

(Унаследовано от DataPointCustomProperties) BackImageWrapMode

Получает или задает режим рисования для фонового изображения. Gets or sets the drawing mode of the background image.

(Унаследовано от DataPointCustomProperties) BackSecondaryColor

Получает или задает вторичный цвет фона. Gets or sets the secondary background color.

(Унаследовано от DataPointCustomProperties) BorderColor

Получает или задает цвет границы точки данных. Gets or sets the border color of the data point.

(Унаследовано от DataPointCustomProperties) BorderDashStyle

Получает или задает стиль границы точки данных. Gets or sets the border style of the data point.

(Унаследовано от DataPointCustomProperties) BorderWidth

Получает или задает ширину границы точки данных. Gets or sets the border width of the data point.

(Унаследовано от DataPointCustomProperties) ChartArea

Получает или задает имя объекта ChartArea, используемого для построения ряда данных, если такой объект имеется. Gets or sets the name of the ChartArea object used to plot the data series, if any.

Получает или задает тип диаграммы для ряда. Gets or sets the chart type of a series.

Получает или задает имя типа диаграммы, используемой для рисования ряда. Gets or sets the name of the chart type used to draw the series.

Получает или задает цвет точки данных. Gets or sets the color of the data point.

(Унаследовано от DataPointCustomProperties) CustomProperties

Получает или задает настраиваемые свойства точки данных. Gets or sets the custom properties of the data point. Пользовательские свойства можно указать в следующем формате: AttrName1=Value1, AttrName2=Value2 и т. д. Custom properties can be specified in the following format: AttrName1=Value1, AttrName2=Value2 .

(Унаследовано от DataPointCustomProperties) CustomPropertiesExtended

Получает или задает расширенные настраиваемые свойства точки данных. Gets or sets the extended custom properties of the data point. Расширенные настраиваемые свойства можно указать в следующем формате: AttrName1=Value1, AttrName2=Value2… Extended custom properties can be specified in the following format: AttrName1=Value1, AttrName2=Value2.

(Унаследовано от DataPointCustomProperties) EmptyPointStyle

Получает или задает стиль рисования точек, помеченных как пустые. Gets or sets the drawing style of points marked as empty.

Получает или задает флаг, указывающий, будет ли ряд отображаться на построенной диаграмме. Gets or sets a flag that indicates whether the series will be visible on the rendered chart.

Получает или задает шрифт точки данных. Gets or sets the font of the data point.

(Унаследовано от DataPointCustomProperties) IsValueShownAsLabel

Получает или задает флаг, указывающий, следует ли отображать значение точки данных на подписи. Gets or sets a flag that indicates whether to show the value of the data point on the label.

(Унаследовано от DataPointCustomProperties) IsVisibleInLegend

Получает или задает флаг, указывающий, отображается ли элемент в легенде. Gets or sets a flag that indicates whether the item is shown in the legend.

(Унаследовано от DataPointCustomProperties) IsXValueIndexed

Получает или задает флаг, указывающий, будут ли использоваться в качестве значений X индексы точек данных. Gets or sets a flag that indicates whether data point indices will be used for the X-values.

Получает объект DataPointCustomProperties по его позиции в индексе. Gets the DataPointCustomProperties object by its position in the index.

(Унаследовано от DataPointCustomProperties) Item[String]

Получает или задает объект DataPointCustomProperties по его имени. Gets or sets the DataPointCustomProperties object by name.

(Унаследовано от DataPointCustomProperties) Label

Получает или задает текст подписи точки данных. Gets or sets the text of the data point label.

(Унаследовано от DataPointCustomProperties) LabelAngle

Получает или задает угол подписи точки данных. Gets or sets the angle of the data point label.

(Унаследовано от DataPointCustomProperties) LabelBackColor

Получает или задает цвет фона для подписи точки данных. Gets or sets the background color of the data point label.

(Унаследовано от DataPointCustomProperties) LabelBorderColor

Получает или задает цвет границы подписи точки данных. Gets or sets the border color of the data point label.

(Унаследовано от DataPointCustomProperties) LabelBorderDashStyle

Получает или задает стиль границы подписи. Gets or sets the border style of the label.

(Унаследовано от DataPointCustomProperties) LabelBorderWidth

Получает или задает ширину границы подписи. Gets or sets the border width of the label.

(Унаследовано от DataPointCustomProperties) LabelForeColor

Получает или задает цвет текста подписи. Gets or sets the text color of the label.

(Унаследовано от DataPointCustomProperties) LabelFormat

Получает или задает формат подписи точки данных. Gets or sets the format of the data point label.

(Унаследовано от DataPointCustomProperties) LabelToolTip

Получает или задает подсказку для подписи точки данных. Gets or sets the tooltip for the data point label.

(Унаследовано от DataPointCustomProperties) Legend

Получает или задает имя ряда, связанного с объектом Legend. Gets or sets the name of the series associated with the Legend object.

Получает или задает текст элемента в легенде. Gets or sets the text of the item in the legend.

(Унаследовано от DataPointCustomProperties) LegendToolTip

Получает или задает подсказку элемента в легенде. Gets or sets the tooltip of the item in the legend.

(Унаследовано от DataPointCustomProperties) MarkerBorderColor

Получает или задает цвет границы маркера. Gets or sets the border color of the marker.

(Унаследовано от DataPointCustomProperties) MarkerBorderWidth

Получает или задает ширину границы маркера. Gets or sets the border width of the marker.

(Унаследовано от DataPointCustomProperties) MarkerColor

Получает или задает цвет маркера. Gets or sets the marker color.

(Унаследовано от DataPointCustomProperties) MarkerImage

Получает или задает изображение маркера. Gets or sets the marker image.

(Унаследовано от DataPointCustomProperties) MarkerImageTransparentColor

Получает или задает цвет, который будет заменен прозрачным цветом при рисовании изображения маркера. Gets or sets the color that will be replaced with a transparent color when the marker image is drawn.

(Унаследовано от DataPointCustomProperties) MarkerSize

Получает или задает размер маркера. Gets or sets the size of the marker.

(Унаследовано от DataPointCustomProperties) MarkerStep

Получает или задает значение, определяющее частоту отображения маркеров точек данных. Gets or sets a value that determines how often to display data point markers.

Получает или задает стиль маркера. Gets or sets the marker style.

(Унаследовано от DataPointCustomProperties) Name

Получает или задает уникальное имя объекта Series. Gets or sets the unique name of a Series object.

Получает или задает цветовую палитру для объекта Series. Gets or sets the color palette of a Series object.

Получает коллекцию точек данных. Gets a collection of data points.

Получает или задает цвет тени для ряда. Gets or sets the shadow color of a series.

Получает или задает смещение тени для ряда (в пикселях). Gets or sets the shadow offset, in pixels, of a series.

Получает или задает стиль смарт-меток. Gets or sets the style of the smart labels.

Получает или задает объект, связанный с данным элементом диаграммы. Gets or sets an object associated with this chart element.

(Унаследовано от ChartElement) ToolTip

Получает или задает подсказку. Gets or sets the tooltip.

(Унаследовано от DataPointCustomProperties) XAxisType

Получает или задает тип оси X для ряда. Gets or sets the X-axis type of the series.

Получает или задает член источника данных диаграммы, используемый для привязки данных к значению X ряда. Gets or sets the member of the chart data source used to data bind to the X-value of the series.

Получает или задает типы значений, построение которых выполняется по оси Х. Gets or sets the value types plotted along the X-axis.

Получает или задает тип оси Y для ряда. Gets or sets the Y-axis type of a series.

Получает или задает столбцы-члены источника данных диаграммы, используемые для привязки данных к значениям Y ряда. Gets or sets member columns of the chart data source used to bind data to the Y-values of the series.

Получает или задает максимальное число значений Y, разрешенное для объектов DataPoint в объекте Series. Gets or sets the maximum number of Y-values that DataPoint objects in a Series are allowed to have.

Получает или задает тип данных значений Y в точках данных, хранящихся в ряде. Gets or sets the type of Y-value data in the data points stored by a series.

Методы

Удаляет настраиваемое свойство точки данных с указанным именем. Deletes the data point custom property with the specified name.

(Унаследовано от DataPointCustomProperties) Dispose()

Освобождает ресурсы, используемые объектом ChartElement. Releases the resources used by the ChartElement.

(Унаследовано от ChartElement) Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом Series, а при необходимости освобождает также управляемые ресурсы. Releases the unmanaged resources used by the Series and optionally releases the managed resources.

Определяет, равен ли указанный экземпляр Object текущему экземпляру ChartElement. Determines whether the specified Object is equal to the current ChartElement.

(Унаследовано от ChartElement) GetCustomProperty(String)

Возвращает настраиваемое свойство точки данных с указанным именем. Returns the data point custom property with the specified name.

(Унаследовано от DataPointCustomProperties) GetHashCode()

Возвращает хэш-функцию для определенного типа. Returns a hash function for a particular type.

(Унаследовано от ChartElement) GetType()

Возвращает объект Type для текущего экземпляра. Gets the Type of the current instance.

(Унаследовано от Object) IsCustomPropertySet(String)

Возвращает значение, определяющее, задано ли настраиваемое свойство с указанным именем. Determines whether a custom property with the specified name was set.

(Унаследовано от DataPointCustomProperties) MemberwiseClone()

Создает неполную копию текущего объекта Object. Creates a shallow copy of the current Object.

(Унаследовано от Object) ResetIsValueShownAsLabel()

Сбрасывает значение настраиваемого свойства к значению по умолчанию. Resets a custom property to its default value.

(Унаследовано от DataPointCustomProperties) ResetIsVisibleInLegend()

Сбрасывает значение настраиваемого свойства к значению по умолчанию. Resets a custom property to its default value.

(Унаследовано от DataPointCustomProperties) SetCustomProperty(String, String)

Задает настраиваемое свойство точки данных. Sets a custom property of the data point.

(Унаследовано от DataPointCustomProperties) SetDefault(Boolean)

Задает свойства по умолчанию для точки данных. Sets the default properties of the data point. Указывает, следует ли удалять предыдущие значения свойств. Indicates whether the previous property values must be cleared.

(Унаследовано от DataPointCustomProperties) Sort(IComparer )

Сортирует точки ряда с использованием интерфейса IComparer. Sorts the points in the series using IComparer interface.

Сортирует точки данных ряда в соответствии с указанным порядком сортировки. Sorts the data points in the series, given the specified sort order.

Сортирует точки ряда в соответствии с указанным порядком сортировки и значением, используемым для сортировки. Sorts the points in the series, given the specified sort order and value to use for the sort.

Возвращает строку, которая представляет текущий объект Object. Returns a string that represents the current Object.