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
Наследование
object ← CollectionBase<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; }
Значение свойства
IsColorVaried
Представляет, изменен ли цвет точек.
public bool IsColorVaried { get; set; }
Значение свойства
SecondCategoryData
Получает или задает диапазон значений второй оси категорий. Это может быть диапазон ячеек (например, “d1:e10”), или последовательность значений (например, “{2,6,8,10}”). Влияет только тогда, когда некоторые ASeries отображаются на второй оси.
public string SecondCategoryData { get; set; }
Значение свойства
this[int]
Получает элемент Aspose.Cells.Charts.Series по указанному индексу.
public Series this[int index] { get; }
Значение свойства
Методы
Add(string, bool)
Добавляет коллекцию Aspose.Cells.Charts.Series к диаграмме.
public int Add(string area, bool isVertical)
Параметры
area
string
Указывает значения, из которых необходимо построить набор данных
isVertical
bool
Указывает, следует ли строить набор данных из диапазона ячеек по строкам или по столбцам.
Возвращает
Возвращает первый индекс добавленного 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
Указывает, содержит ли диапазон имена серии.
Возвращает
Возвращает первый индекс добавленного 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
Указывает, следует ли строить набор данных из диапазона ячеек по строкам или по столбцам.
Возвращает
Возвращает первый индекс добавленного 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
Порядок серии
Возвращает
Элемент серии
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
Индекс назначения