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

继承

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; }

属性值

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

目标索引

 中文