Class SeriesCollection

Class SeriesCollection

Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)

Инкапсулирует коллекцию объектов Aspose.Cells.Charts.Series.

public class SeriesCollection : CollectionBase<series>, IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerable

Наследование

objectCollectionBase<series>SeriesCollection

Реализует

IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerable

Унаследованные члены

CollectionBase<series>.BinarySearch(Series), CollectionBase<series>.BinarySearch(Series, IComparer<series>), CollectionBase<series>.BinarySearch(int, int, Series, IComparer<series>), CollectionBase<series>.Contains(Series), CollectionBase<series>.CopyTo(Series[]), CollectionBase<series>.CopyTo(Series[], int), CollectionBase<series>.CopyTo(int, Series[], int, int), CollectionBase<series>.Exists(Predicate<series>), CollectionBase<series>.Find(Predicate<series>), CollectionBase<series>.FindAll(Predicate<series>), CollectionBase<series>.FindIndex(Predicate<series>), CollectionBase<series>.FindIndex(int, Predicate<series>), CollectionBase<series>.FindIndex(int, int, Predicate<series>), CollectionBase<series>.FindLast(Predicate<series>), CollectionBase<series>.FindLastIndex(Predicate<series>), CollectionBase<series>.FindLastIndex(int, Predicate<series>), CollectionBase<series>.FindLastIndex(int, int, Predicate<series>), CollectionBase<series>.IndexOf(Series), CollectionBase<series>.IndexOf(Series, int), CollectionBase<series>.IndexOf(Series, int, int), CollectionBase<series>.LastIndexOf(Series), CollectionBase<series>.LastIndexOf(Series, int), CollectionBase<series>.LastIndexOf(Series, int, int), CollectionBase<series>.GetEnumerator(), CollectionBase<series>.Clear(), CollectionBase<series>.RemoveAt(int), CollectionBase<series>.OnClearComplete(), CollectionBase<series>.OnClear(), CollectionBase<series>.Capacity, CollectionBase<series>.Count, CollectionBase<series>.InnerList, CollectionBase<series>.this[int], 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"
chart.NSeries.Add("A1:B4", true);
//Установка источника данных для категориальных данных NSeries
chart.NSeries.CategoryData = "C1:C4";
//Сохранение файла Excel
workbook.Save("book1.xls");
'Создание объекта Workbook
Dim workbook As Workbook = New Workbook()
'Добавление нового листа в объект Excel
Dim sheetIndex As Integer = 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 Integer = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Доступ к экземпляру только что добавленной диаграммы
Dim chart As Chart = worksheet.Charts(chartIndex)
'Добавление NSeries (источник данных диаграммы) в диаграмму в диапазоне от ячейки "A1" до "B4"
chart.NSeries.Add("A1:B4", True)
'Установка источника данных для категориальных данных NSeries
chart.NSeries.CategoryData = "C1:C4"
'Сохранение файла Excel
workbook.Save("book1.xls")

Свойства

CategoryData

Получает или задает диапазон значений оси категорий. Это может быть диапазон ячеек (например, “d1:e10”), или последовательность значений (например, “{2,6,8,10}”).

public string CategoryData { get; set; }

Значение свойства

string

IsColorVaried

Представляет, изменен ли цвет точек.

public bool IsColorVaried { get; set; }

Значение свойства

bool

SecondCategoryData

Получает или задает диапазон значений второй оси категорий. Это может быть диапазон ячеек (например, “d1:e10”), или последовательность значений (например, “{2,6,8,10}”). Влияет только тогда, когда некоторые ASeries отображаются на второй оси.

public string SecondCategoryData { get; set; }

Значение свойства

string

this[int]

Получает элемент Aspose.Cells.Charts.Series по указанному индексу.

public Series this[int index] { get; }

Значение свойства

Series

Методы

Add(string, bool)

Добавляет коллекцию Aspose.Cells.Charts.Series к диаграмме.

public int Add(string area, bool isVertical)

Параметры

area string

Указывает значения, из которых необходимо построить набор данных

isVertical bool

Указывает, следует ли строить набор данных из диапазона ячеек по строкам или по столбцам.

Возвращает

int

Возвращает первый индекс добавленного ASeries в NSeries.

Примечания


Если устанавливаете данные на смежных ячейках, используйте двоеточие для их разделения. Например, $C$2:$C$5.
Если устанавливаете данные на несмежных ячейках, используйте запятую для их разделения. Например: ($C$2,$D$5).

Add(string, bool, bool)

Добавляет коллекцию Aspose.Cells.Charts.Series к диаграмме.

public int Add(string area, bool isVertical, bool checkLabels)

Параметры

area string

Указывает значения, из которых необходимо построить набор данных

isVertical bool

Указывает, следует ли строить набор данных из диапазона ячеек по строкам или по столбцам.

checkLabels bool

Указывает, содержит ли диапазон имена серии.

Возвращает

int

Возвращает первый индекс добавленного ASeries в NSeries.

Примечания


Если устанавливаете данные на смежных ячейках, используйте двоеточие для их разделения. Например, $C$2:$C$5.
Если устанавливаете данные на несмежных ячейках, используйте запятую для их разделения. Например: ($C$2,$D$5).

AddR1C1(string, bool)

Добавляет коллекцию Aspose.Cells.Charts.Series к диаграмме.

public int AddR1C1(string area, bool isVertical)

Параметры

area string

Указывает значения, из которых необходимо построить набор данных

isVertical bool

Указывает, следует ли строить набор данных из диапазона ячеек по строкам или по столбцам.

Возвращает

int

Возвращает первый индекс добавленного ASeries в NSeries.

Примечания


Если устанавливаете данные на смежных ячейках, используйте двоеточие для их разделения. Например, R[1]C[1]:R[3]C[2].
Если устанавливаете данные на несмежных ячейках, используйте запятую для их разделения. Например,(R[1]C[1],R[3]C[2]).

Clear()

Очищает коллекцию

public void Clear()

GetSeriesByOrder(int)

Получает элемент Aspose.Cells.Charts.Series по порядку.

public Series GetSeriesByOrder(int order)

Параметры

order int

Порядок серии

Возвращает

Series

Элемент серии

RemoveAt(int)

Удаляет серию по указанному индексу.

public void RemoveAt(int index)

Параметры

index int

Индекс.

SetSeriesNames(int, string, bool)

Устанавливает имя всех серий в диаграмме.

public void SetSeriesNames(int startIndex, string area, bool isVertical)

Параметры

startIndex int

Индекс первой серии, для которой вы хотите установить имя.

area string

Указывает область для имени серии.

isVertical bool

>Указывает, следует ли строить набор данных из диапазона ячеек по строкам или по столбцам.

Примечания


Если начальный индекс больше количества серий, он вернется и ничего не сделает.
Если устанавливаете данные на смежных ячейках, используйте двоеточие для их разделения. Например, $C$2:$C$5.
Если устанавливаете данные на несмежных ячейках, используйте запятую для их разделения. Например, ($C$2,$D$5).

SwapSeries(int, int)

Непосредственно изменяет порядок двух серий.

public void SwapSeries(int sourceIndex, int destIndex)

Параметры

sourceIndex int

Текущий индекс

destIndex int

Индекс назначения

 Русский