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-форми, що використовується з 3-D стовпцевою або стовпцевою діаграмою.
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
Отримує або задає кут першого скибки діаграми пирога або діаграми у вигляді пончика, в градусах (за годинниковою стрілкою з вертикалі). Застосовується лише до діаграм пирога, 3-D пирога та пончиків, від 0 до 360.
public short FirstSliceAngle { get; set; }Значення властивості
GapWidth
Повертає або задає простір між кластерами стержнів або стовпців, як відсоток від ширини стержня або стовпця. Значення цієї властивості повинно бути між 0 і 500.
public short GapWidth { get; set; }Значення властивості
Has3DEffect
True, якщо серія має тривимірний вигляд. Застосовується лише до бульбашкових діаграм.
public bool Has3DEffect { get; set; }Значення властивості
HasDropLines
True, якщо діаграма має лінії падіння. Застосовується лише до лінійних діаграм або діаграм області.
public bool HasDropLines { get; set; }Значення властивості
HasHiLoLines
True, якщо лінійна діаграма має лінії високих і низьких значень. Застосовується лише до лінійних діаграм.
public bool HasHiLoLines { get; set; }Значення властивості
HasLeaderLines
True, якщо серія має лінії лідерів.
public bool HasLeaderLines { get; set; }Значення властивості
HasRadarAxisLabels
True, якщо радарна діаграма має мітки осі категорії. Застосовується лише до радарних діаграм.
public bool HasRadarAxisLabels { get; set; }Значення властивості
HasSeriesLines
True, якщо стовпцева діаграма або стержнева діаграма має лінії серії або якщо діаграма “Пиріг з пирогом” або “Стержень з пирогом” має лінії з’єднання між двома секціями. Застосовується лише до стовпцевих діаграм, стержневих діаграм, діаграм “Пиріг з пирогом” або “Стержень з пирогом”.
public bool HasSeriesLines { get; set; }Значення властивості
HasUpDownBars
True, якщо лінійна діаграма має верхні та нижні стержні. Застосовується лише до лінійних діаграм.
public bool HasUpDownBars { get; set; }Значення властивості
HiLoLines
Повертає об’єкт HiLoLines, що представляє лінії високих і низьких значень для серії на лінійній діаграмі. Застосовується лише до лінійних діаграм.
public Line HiLoLines { get; }Значення властивості
IsAutoSplit
Вказує, чи є граничне значення автоматичним.
public bool IsAutoSplit { get; }Значення властивості
IsColorVaried
Представляє, чи змінюється колір точок. Діаграма повинна містити лише одну серію.
public bool IsColorVaried { get; set; }Значення властивості
IsFiltered
Вказує, чи серія вибрана або відфільтрована. True означає, що ця серія відфільтрована, і вона не буде відображатися на діаграмі.
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=маркер.
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. Застосовується лише до 2-D стержневих та 2-D стовпцевих діаграм.
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
True, якщо серія має тінь.
public bool Shadow { get; set; }Значення властивості
ShapeProperties
Отримує об’єкт Aspose.Cells.Drawing.ShapePropertyCollection, що містить візуальні властивості форми серії.
public ShapePropertyCollection ShapeProperties { get; }Значення властивості
ShowNegativeBubbles
True, якщо негативні бульбашки відображаються для групи діаграм. Дійсно лише для бульбашкових діаграм.
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
Представляє згладжування кривої. True, якщо згладжування кривої увімкнено для лінійної або розсіяної діаграми. Застосовується лише до лінійних та розсіяних діаграм, з’єднаних лініями.
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
Кількість переміщення вгору або вниз. Перемістіть серію вгору, якщо це менше нуля; Перемістіть серію вниз, якщо це більше нуля.
