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
Індекс призначення
