Series

Series class

Инкапсулирует объект, представляющий один ряд данных на диаграмме.

public class Series

Характеристики

ИмяОписание
Area { get; }Представляет фоновую область объекта Series.
Bar3DShapeType { get; set; }Получает или задает тип трехмерной фигуры, используемый с трехмерной гистограммой или гистограммой.
Border { get; }Представляет границу объекта Series.
BubbleScale { get; set; }Получает или задает коэффициент масштабирования для пузырьков в указанной группе диаграммы. Может быть целым числом от 0 (ноль) до 300, соответствует проценту от размера по умолчанию. Применяется только к пузырьковым диаграммам.
BubbleSizes { get; set; }Получает или задает значения размеров пузырьков серии диаграммы.
CountOfDataValues { get; }Получает количество значений данных.
DataLabels { get; }Представляет объект DataLabels для указанного ASeries.
DisplayName { get; }Получает имя серии, которое отображается на диаграмме.
DoughnutHoleSize { get; set; }Возвращает или задает размер отверстия в группе кольцевой диаграммы. Размер отверстия выражается в процентах от размера диаграммы в диапазоне от 10 до 90 процентов.
DownBars { get; }ВозвращаетDropBars объект, представляющий нижние бары на линейном графике. Применяется только к линейным графикам.
DropLines { get; }ВозвращаетLine объект, представляющий перетаскиваемые линии для ряда на линейной диаграмме или диаграмме с областями. Применяется только к линейной диаграмме или диаграмме с областями.
Explosion { get; set; }Расстояние открытого среза круговой диаграммы от центра круговой диаграммы выражается в процентах от диаметра круговой диаграммы.
FirstSliceAngle { get; set; }Получает или задает угол первого фрагмента круговой диаграммы или кольцевой диаграммы в градусах (по часовой стрелке от вертикали). Применяется только к круговым, трехмерным круговым и кольцевым диаграммам, от 0 до 360.
GapWidth { get; set; }Возвращает или задает расстояние между кластерами столбцов или столбцов в процентах от ширины столбца или столбца. Значение этого свойства должно быть в диапазоне от 0 до 500.
Has3DEffect { get; set; }Истинно, если серия имеет трехмерный вид. Применяется только к пузырьковым диаграммам.
HasDropLines { get; set; }Истинно, если на диаграмме есть перетаскиваемые линии. Применяется только к линейным диаграммам или диаграммам с областями.
HasHiLoLines { get; set; }Истинно, если на линейном графике есть линии максимума-минимума. Применяется только к линейным графикам.
HasLeaderLines { get; set; }Истинно, если ряд имеет линии выноски.
HasRadarAxisLabels { get; set; }Истинно, если лепестковая диаграмма имеет метки осей категорий. Применяется только к радиолокационным картам.
HasSeriesLines { get; set; }Истинно, если столбчатая диаграмма с накоплением или столбчатая диаграмма имеет линии серий, или , если круговая диаграмма или столбчатая диаграмма имеет соединительные линии между двумя разделами. Применяется только к столбчатым диаграммам с накоплением, столбчатым диаграммам, круговым диаграммам или столбчатым диаграммам.
HasUpDownBars { get; set; }Истинно, если линейный график имеет столбцы вверх и вниз. Применяется только к линейным графикам.
HiLoLines { get; }Возвращает объект HiLoLines, представляющий линии максимума и минимума для ряда на линейной диаграмме. Применяется только к линейным графикам.
IsAutoSplit { get; }Указывает, является ли пороговое значение автоматическим.
IsColorVaried { get; set; }Указывает, изменился ли цвет точек. Диаграмма должна содержать только одну серию.
IsVerticalValues { get; }Указывает, является ли источник данных вертикальным.
LayoutProperties { get; }Представляет свойства макета.
LeaderLines { get; }Представляет линии выноски на диаграмме. Линии выноски соединяют метки данных с точками данных. Этот объект не является коллекцией; нет объекта, представляющего одну линию выноски.
LegendEntry { get; }Получает запись легенды в соответствии с этой серией.
Marker { get; }Получаетмаркер .
Name { get; set; }Получает или задает имя серии данных.
Overlap { get; set; }Определяет расположение столбцов и столбцов. Может принимать значение от – 100 до 100. Применяется только к двухмерным линейчатым и двумерным столбчатым диаграммам.
PlotOnSecondAxis { get; set; }Указывает, нанесен ли этот ряд на вторую ось значений.
Points { get; }Получает набор точек в серии на диаграмме.
SecondPlotSize { get; set; }Возвращает или задает размер вторичного раздела круговой диаграммы или столбца круговой диаграммы, в процентах от размера основного круга. Может принимать значение от 5 до 200.
SeriesLines { get; }Возвращает объект SeriesLines, представляющий линии ряда для гистограммы с накоплением или гистограммы с накоплением. Применяется только к столбчатым диаграммам с накоплением и гистограммам с накоплением.
Shadow { get; set; }Истинно, если у серии есть тень.
ShapeProperties { get; }Получает объект, который содержит свойства визуальной формы Series.
ShowNegativeBubbles { get; set; }Истинно, если для группы диаграммы отображаются отрицательные кружки. Действительно только для пузырьковых диаграмм.
SizeRepresents { get; set; }Получает или задает значение размера пузырька на пузырьковой диаграмме.
Smooth { get; set; }Представляет сглаживание кривой. Истинно, если сглаживание кривой включено для линейного графика или точечной диаграммы. Применяется только к линейному и точечному графикам, соединенным линейными диаграммами.
SplitType { get; set; }Возвращает или задает значение, позволяющее определить, какие точки данных находятся во второй круговой диаграмме или столбце круговой диаграммы или столбца круговой диаграммы .
SplitValue { get; set; }Возвращает или задает значение, которое должно использоваться для определения того, какие точки данных находятся во втором круге или столбце на круговом круге или столбце круговой диаграммы.
TrendLines { get; }Возвращает объект, представляющий набор всех линий тренда для серии.
Type { get; set; }Получает или задает тип ряда данных.
UpBars { get; }Возвращает объект DropBars, представляющий столбцы вверх на линейном графике. Применяется только к линейным графикам.
Values { get; set; }Представляет данные серии диаграммы.
ValuesFormatCode { get; set; }Представляет код формата списка номеров значений.
XErrorBar { get; }Представляет линейку погрешностей направления X серии.
XValues { get; set; }Представляет значения x ряда диаграммы.
YErrorBar { get; }Представляет полосу ошибок направления Y серии.

Методы

ИмяОписание
Move(int)Перемещает ряд вверх или вниз.

Примеры


[C#]

//Создание экземпляра объекта Workbook
Workbook workbook = new Workbook();
//Добавление нового рабочего листа в объект Excel
int sheetIndex = workbook.Worksheets.Add();
//Получение ссылки на недавно добавленный рабочий лист путем передачи его индекса листа
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Добавление пробного значения в ячейку "A1"
worksheet.Cells["A1"].PutValue(50);
//Добавление образца значения в ячейку "A2"
worksheet.Cells["A2"].PutValue(100);
//Добавление образца значения в ячейку "A3"
worksheet.Cells["A3"].PutValue(150);
//Добавление образца значения в ячейку "A4"
worksheet.Cells["A4"].PutValue(200);
//Добавление образца значения в ячейку "B1"
worksheet.Cells["B1"].PutValue(60);
//Добавление образца значения в ячейку "B2"
worksheet.Cells["B2"].PutValue(32);
//Добавление образца значения в ячейку "B3"
worksheet.Cells["B3"].PutValue(50);
//Добавление образца значения в ячейку "B4"
worksheet.Cells["B4"].PutValue(40);
//Добавление образца значения в ячейку "C1" в качестве данных категории
worksheet.Cells["C1"].PutValue("Q1");
//Добавление образца значения в ячейку "C2" в качестве данных категории
worksheet.Cells["C2"].PutValue("Q2");
//Добавление образца значения в ячейку "C3" в качестве данных категории
worksheet.Cells["C3"].PutValue("Y1");
//Добавление образца значения в ячейку "C4" в качестве данных категории
worksheet.Cells["C4"].PutValue("Y2");
//Добавляем диаграмму на рабочий лист
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//Доступ к экземпляру только что добавленного графика
Chart chart = worksheet.Charts[chartIndex];
//Добавление NSeries (источника данных диаграммы) на диаграмму в диапазоне от ячейки "A1" до "B4"
int seriesIndex = chart.NSeries.Add("A1:B4", true);
//Установка источника данных для данных категории NSeries
chart.NSeries.CategoryData = "C1:C4";
Series series = chart.NSeries[seriesIndex];
//Установка значений ряда.
series.Values = "=B1:B4";
//Изменяем тип графика серии.
series.Type = ChartType.Line;
//Установка свойств маркера.
series.Marker.MarkerStyle = ChartMarkerType.Circle;
series.Marker.ForegroundColorSetType = FormattingType.Automatic;
series.Marker.ForegroundColor = System.Drawing.Color.Black;
series.Marker.BackgroundColorSetType = FormattingType.Automatic;

//делай свое дело

//Сохранение файла Excel
workbook.Save("book1.xls");

[Visual Basic]

'Создание экземпляра объекта Workbook
Dim workbook As Workbook = New Workbook()
'Добавление нового рабочего листа в объект Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Получение ссылки на недавно добавленный рабочий лист путем передачи его индекса листа
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Adding a sample value to "A1" cell
worksheet.Cells("A1").PutValue(50)
'Adding a sample value to "A2" cell
worksheet.Cells("A2").PutValue(100)
'Adding a sample value to "A3" cell
worksheet.Cells("A3").PutValue(150)
'Adding a sample value to "A4" cell
worksheet.Cells("A4").PutValue(200)
'Adding a sample value to "B1" cell
worksheet.Cells("B1").PutValue(60)
'Adding a sample value to "B2" cell
worksheet.Cells("B2").PutValue(32)
'Adding a sample value to "B3" cell
worksheet.Cells("B3").PutValue(50)
'Adding a sample value to "B4" cell
worksheet.Cells("B4").PutValue(40)
'Adding a sample value to "C1" cell as category data
worksheet.Cells("C1").PutValue("Q1")
'Adding a sample value to "C2" cell as category data
worksheet.Cells("C2").PutValue("Q2")
'Adding a sample value to "C3" cell as category data
worksheet.Cells("C3").PutValue("Y1")
'Adding a sample value to "C4" cell as category data
worksheet.Cells("C4").PutValue("Y2")
'Добавление диаграммы на рабочий лист
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Доступ к экземпляру вновь добавленной диаграммы
Dim chart As Chart = worksheet.Charts(chartIndex)
'Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B4"
Dim seriesIndex As Int32 = chart.NSeries.Add("A1:B4", True)
'Установка источника данных для данных категории NSeries
chart.NSeries.CategoryData = "C1:C4"
Dim series As Series = chart.NSeries(seriesIndex)
'Установка значений ряда.
series.Values = "=B1:B4"
'Изменение типа диаграммы ряда.
series.Type = ChartType.Line
'Настройка свойств маркера.
series.Marker.MarkerStyle = ChartMarkerType.Circle
series.Marker.ForegroundColorSetType = FormattingType.Automatic
series.Marker.ForegroundColor = System.Drawing.Color.Black
series.Marker.BackgroundColorSetType = FormattingType.Automatic
'Сохранение файла Excel
workbook.Save("book1.xls")

Смотрите также

QuartileCalculationType SeriesCollection