Class Series
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Инкапсулирует объект, представляющий одну серию данных в диаграмме.
public class SeriesНаследование
Унаследованные члены
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Примеры
//Создание объекта 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");'Создание объекта Workbook
Dim workbook As Workbook = New Workbook()
'Добавление нового листа в объект Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Получение ссылки на только что добавленный лист, передав его индекс
Dim worksheet As 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")
'Добавление диаграммы на лист
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Доступ к экземпляру только что добавленной диаграммы
Dim chart As Chart = worksheet.Charts(chartIndex)
'Добавление NSeries (источник данных диаграммы) в диапазоне от ячейки "A1" до "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")Свойства
Area
Представляет фоновую область объекта Series.
public Area Area { get; }Значение свойства
Bar3DShapeType
Получает или устанавливает тип 3D-формы, используемый с 3D-гистограммами или столбчатыми диаграммами.
public Bar3DShapeType Bar3DShapeType { get; set; }Значение свойства
Border
Представляет границу объекта Series.
public Line Border { get; }Значение свойства
BubbleScale
Получает или устанавливает коэффициент масштаба для пузырьков в указанной группе диаграмм. Это может быть целочисленное значение от 0 (ноль) до 300, что соответствует проценту от стандартного размера. Применяется только к пузырьковым диаграммам.
public int BubbleScale { get; set; }Значение свойства
BubbleSizes
Получает или устанавливает значения размеров пузырьков диаграммы.
public string BubbleSizes { get; set; }Значение свойства
CountOfDataValues
Получает количество значений данных.
public int CountOfDataValues { get; }Значение свойства
DataLabels
Представляет объект DataLabels для указанной ASeries.
public DataLabels DataLabels { get; }Значение свойства
DisplayName
Получает имя серии, которое отображается на графике диаграммы.
public string DisplayName { get; }Значение свойства
DoughnutHoleSize
Возвращает или устанавливает размер отверстия в группе круговой диаграммы. Размер отверстия выражается в процентах от размера диаграммы, от 10 до 90 процентов.
public int DoughnutHoleSize { get; set; }Значение свойства
DownBars
Возвращает объект Aspose.Cells.Charts.DropBars, который представляет нижние бары на линейной диаграмме. Применяется только к линейным диаграммам.
public DropBars DownBars { get; }Значение свойства
DropLines
Возвращает объект Aspose.Cells.Drawing.Line, который представляет линии падения для серии на линейной диаграмме или площадной диаграмме. Применяется только к линейным диаграммам или площадным диаграммам.
public Line DropLines { get; }Значение свойства
Explosion
Расстояние открытого сегмента пирога от центра круговой диаграммы выражается в процентах от диаметра пирога.
public int Explosion { get; set; }Значение свойства
FirstSliceAngle
Получает или устанавливает угол первого сегмента круговой диаграммы или круговой диаграммы, в градусах (по часовой стрелке от вертикали). Применяется только к круговым, 3D-круговым и круговым диаграммам, от 0 до 360.
public short FirstSliceAngle { get; set; }Значение свойства
GapWidth
Возвращает или устанавливает пространство между группами баров или столбцов, как процент от ширины бара или столбца. Значение этого свойства должно быть от 0 до 500.
public short GapWidth { get; set; }Значение свойства
Has3DEffect
Истина, если серия имеет трехмерный вид. Применяется только к пузырьковым диаграммам.
public bool Has3DEffect { get; set; }Значение свойства
HasDropLines
Истина, если диаграмма имеет линии падения. Применяется только к линейным диаграммам или площадным диаграммам.
public bool HasDropLines { get; set; }Значение свойства
HasHiLoLines
Истина, если линейная диаграмма имеет линии высоких и низких значений. Применяется только к линейным диаграммам.
public bool HasHiLoLines { get; set; }Значение свойства
HasLeaderLines
Истина, если серия имеет линии лидера.
public bool HasLeaderLines { get; set; }Значение свойства
HasRadarAxisLabels
Истина, если у радиальной диаграммы есть метки оси категорий. Применяется только к радиальным диаграммам.
public bool HasRadarAxisLabels { get; set; }Значение свойства
HasSeriesLines
Истина, если столбчатая диаграмма или диаграмма с накоплением имеет линии серии или если круговая диаграмма с кругом или столбчатая диаграмма с кругом имеет соединительные линии между двумя секциями. Применяется только к столбчатым диаграммам с накоплением, круговым диаграммам или столбчатым диаграммам с кругом.
public bool HasSeriesLines { get; set; }Значение свойства
HasUpDownBars
Истина, если линейная диаграмма имеет восходящие и нисходящие бары. Применяется только к линейным диаграммам.
public bool HasUpDownBars { get; set; }Значение свойства
HiLoLines
Возвращает объект HiLoLines, который представляет линии высоких и низких значений для серии на линейной диаграмме. Применяется только к линейным диаграммам.
public Line HiLoLines { get; }Значение свойства
IsAutoSplit
Указывает, является ли пороговое значение автоматическим.
public bool IsAutoSplit { get; }Значение свойства
IsColorVaried
Представляет, варьируется ли цвет точек. Диаграмма должна содержать только одну серию.
public bool IsColorVaried { get; set; }Значение свойства
IsFiltered
Указывает, выбрана ли серия или отфильтрована. Истина означает, что эта серия отфильтрована и не будет отображаться на диаграмме.
public bool IsFiltered { get; set; }Значение свойства
IsVerticalValues
Указывает, является ли источник данных вертикальным.
public bool IsVerticalValues { get; }Значение свойства
LayoutProperties
Представляет свойства компоновки.
public SeriesLayoutProperties LayoutProperties { get; }Значение свойства
LeaderLines
Представляет линии лидера на диаграмме. Линии лидера соединяют метки данных с точками данных. Этот объект не является коллекцией; нет объекта, представляющего одну линию лидера.
public Line LeaderLines { get; }Значение свойства
LegendEntry
Получает элемент легенды в соответствии с этой серией.
public LegendEntry LegendEntry { get; }Значение свойства
Marker
Получает маркер Aspose.Cells.Charts.Series.Marker?text=marker.
public Marker Marker { get; }Значение свойства
Name
Получает или устанавливает имя серии данных.
public string Name { get; set; }Примеры
//Ссылка на имя в ячейке
chart.NSeries[0].Name = "=A1";
//Установка строки в качестве имени
chart.NSeries[0].Name = "Первая серия";'Ссылка на имя в ячейке
chart.NSeries[0].Name = "=A1"
'Установка строки в качестве имени
chart.NSeries[0].Name = "Первая серия"Overlap
Указывает, как расположены бары и столбцы. Может быть значением от – 100 до 100. Применяется только к 2D-гистограммам и 2D-столбчатым диаграммам.
public short Overlap { get; set; }Значение свойства
PlotOnSecondAxis
Указывает, если эта серия отображается на второй оси значений.
public bool PlotOnSecondAxis { get; set; }Значение свойства
Points
Получает коллекцию точек в серии на диаграмме.
public ChartPointCollection Points { get; }Значение свойства
Примечания
Когда диаграмма является круговой диаграммой с кругом или столбчатой диаграммой с кругом, последняя точка является другой точкой в первом круговом графике.
SecondPlotSize
Возвращает или устанавливает размер вторичной секции либо круговой диаграммы с кругом, либо столбчатой диаграммы с кругом, в процентах от размера основной круговой диаграммы. Может быть значением от 5 до 200.
public short SecondPlotSize { get; set; }Значение свойства
SeriesLines
Возвращает объект SeriesLines, который представляет линии серии для столбчатой диаграммы с накоплением или столбчатой диаграммы с накоплением. Применяется только к столбчатым диаграммам с накоплением и столбчатым диаграммам с накоплением.
public Line SeriesLines { get; }Значение свойства
Shadow
Истина, если серия имеет тень.
public bool Shadow { get; set; }Значение свойства
ShapeProperties
Получает объект Aspose.Cells.Drawing.ShapePropertyCollection, который содержит визуальные свойства формы серии.
public ShapePropertyCollection ShapeProperties { get; }Значение свойства
ShowNegativeBubbles
Истина, если отрицательные пузырьки отображаются для группы диаграмм. Действительно только для пузырьковых диаграмм.
public bool ShowNegativeBubbles { get; set; }Значение свойства
SizeRepresents
Получает или устанавливает, что размер пузырька представляет на пузырьковой диаграмме.
public BubbleSizeRepresents SizeRepresents { get; set; }Значение свойства
Примечания
BubbleSizeRepresents.SizeIsArea означает, что значение Aspose.Cells.Charts.Series.BubbleSizes является площадью пузырька. BubbleSizeRepresents.SizeIsWidth означает, что значение Aspose.Cells.Charts.Series.BubbleSizes является шириной пузырька.
Smooth
Представляет сглаживание кривой. Истина, если сглаживание кривой включено для линейной диаграммы или диаграммы разброса. Применяется только к линейным и диаграммам разброса, соединенным линиями.
public bool Smooth { get; set; }Значение свойства
SplitType
Возвращает или устанавливает значение, как определить, какие точки данных находятся во втором круге или баре на круговой диаграмме с кругом или столбчатой диаграмме с кругом.
public ChartSplitType SplitType { get; set; }Значение свойства
SplitValue
Возвращает или устанавливает значение, которое будет использоваться для определения, какие точки данных находятся во втором круге или баре на круговой диаграмме с кругом или столбчатой диаграмме с кругом.
public double SplitValue { get; set; }Значение свойства
TrendLines
Возвращает все линии тренда этой серии.
public TrendlineCollection TrendLines { get; }Значение свойства
Type
Получает или устанавливает тип серии данных.
public ChartType Type { get; set; }Значение свойства
UpBars
Возвращает объект DropBars, который представляет восходящие бары на линейной диаграмме. Применяется только к линейным диаграммам.
public DropBars UpBars { get; }Значение свойства
Values
Представляет Y-значения этой серии диаграммы.
public string Values { get; set; }Значение свойства
ValuesFormatCode
Представляет код формата списка чисел значений.
public string ValuesFormatCode { get; set; }Значение свойства
XErrorBar
Представляет ошибку в направлении X для серии.
public ErrorBar XErrorBar { get; }Значение свойства
XValues
Представляет X-значения серии диаграммы.
public string XValues { get; set; }Значение свойства
XValuesFormatCode
Представляет код формата списка чисел X-значений.
public string XValuesFormatCode { get; set; }Значение свойства
YErrorBar
Представляет ошибку в направлении Y для серии.
public ErrorBar YErrorBar { get; }Значение свойства
Методы
Move(int)
Перемещает серию вверх или вниз.
public void Move(int count)Параметры
count int
Количество перемещений вверх или вниз. Переместите серию вверх, если это значение меньше нуля; Переместите серию вниз, если это значение больше нуля.
