Class SeriesCollection
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Encapsula uma coleção de objetos Aspose.Cells.Charts.Series.
public class SeriesCollection : CollectionBase<series>, IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerableHerança
object ← CollectionBase<series> ← SeriesCollection
Implementa
IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerable
Membros Herdados
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()
Exemplos
//Instanciando um objeto Workbook
Workbook workbook = new Workbook();
//Adicionando uma nova planilha ao objeto Excel
int sheetIndex = workbook.Worksheets.Add();
//Obtendo a referência da nova planilha adicionada passando seu índice
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Adicionando um valor de exemplo à célula "A1"
worksheet.Cells["A1"].PutValue(50);
//Adicionando um valor de exemplo à célula "A2"
worksheet.Cells["A2"].PutValue(100);
//Adicionando um valor de exemplo à célula "A3"
worksheet.Cells["A3"].PutValue(150);
//Adicionando um valor de exemplo à célula "A4"
worksheet.Cells["A4"].PutValue(200);
//Adicionando um valor de exemplo à célula "B1"
worksheet.Cells["B1"].PutValue(60);
//Adicionando um valor de exemplo à célula "B2"
worksheet.Cells["B2"].PutValue(32);
//Adicionando um valor de exemplo à célula "B3"
worksheet.Cells["B3"].PutValue(50);
//Adicionando um valor de exemplo à célula "B4"
worksheet.Cells["B4"].PutValue(40);
//Adicionando um valor de exemplo à célula "C1" como dados de categoria
worksheet.Cells["C1"].PutValue("Q1");
//Adicionando um valor de exemplo à célula "C2" como dados de categoria
worksheet.Cells["C2"].PutValue("Q2");
//Adicionando um valor de exemplo à célula "C3" como dados de categoria
worksheet.Cells["C3"].PutValue("Y1");
//Adicionando um valor de exemplo à célula "C4" como dados de categoria
worksheet.Cells["C4"].PutValue("Y2");
//Adicionando um gráfico à planilha
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//Acessando a instância do gráfico recém-adicionado
Chart chart = worksheet.Charts[chartIndex];
//Adicionando NSeries (fonte de dados do gráfico) ao gráfico variando da célula "A1" à "B4"
chart.NSeries.Add("A1:B4", true);
//Definindo a fonte de dados para os dados de categoria do NSeries
chart.NSeries.CategoryData = "C1:C4";
//Salvando o arquivo Excel
workbook.Save("book1.xls");'Instanciando um objeto Workbook
Dim workbook As Workbook = New Workbook()
'Adicionando uma nova planilha ao objeto Excel
Dim sheetIndex As Integer = workbook.Worksheets.Add()
'Obtendo a referência da nova planilha adicionada passando seu índice
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Adicionando um valor de exemplo à célula "A1"
worksheet.Cells("A1").PutValue(50)
'Adicionando um valor de exemplo à célula "A2"
worksheet.Cells("A2").PutValue(100)
'Adicionando um valor de exemplo à célula "A3"
worksheet.Cells("A3").PutValue(150)
'Adicionando um valor de exemplo à célula "A4"
worksheet.Cells("A4").PutValue(200)
'Adicionando um valor de exemplo à célula "B1"
worksheet.Cells("B1").PutValue(60)
'Adicionando um valor de exemplo à célula "B2"
worksheet.Cells("B2").PutValue(32)
'Adicionando um valor de exemplo à célula "B3"
worksheet.Cells("B3").PutValue(50)
'Adicionando um valor de exemplo à célula "B4"
worksheet.Cells("B4").PutValue(40)
'Adicionando um valor de exemplo à célula "C1" como dados de categoria
worksheet.Cells("C1").PutValue("Q1")
'Adicionando um valor de exemplo à célula "C2" como dados de categoria
worksheet.Cells("C2").PutValue("Q2")
'Adicionando um valor de exemplo à célula "C3" como dados de categoria
worksheet.Cells("C3").PutValue("Y1")
'Adicionando um valor de exemplo à célula "C4" como dados de categoria
worksheet.Cells("C4").PutValue("Y2")
'Adicionando um gráfico à planilha
Dim chartIndex As Integer = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Acessando a instância do gráfico recém-adicionado
Dim chart As Chart = worksheet.Charts(chartIndex)
'Adicionando NSeries (fonte de dados do gráfico) ao gráfico variando da célula "A1" à "B4"
chart.NSeries.Add("A1:B4", True)
'Definindo a fonte de dados para os dados de categoria do NSeries
chart.NSeries.CategoryData = "C1:C4"
'Salvando o arquivo Excel
workbook.Save("book1.xls")Propriedades
CategoryData
Obtém ou define o intervalo de valores do eixo de categoria. Pode ser um intervalo de células (como, “d1:e10”), ou uma sequência de valores (como,"{2,6,8,10}").
public string CategoryData { get; set; }Valor da Propriedade
IsColorVaried
Representa se a cor dos pontos é variada.
public bool IsColorVaried { get; set; }Valor da Propriedade
SecondCategoryData
Obtém ou define o intervalo de valores do segundo eixo de categoria. Pode ser um intervalo de células (como, “d1:e10”), ou uma sequência de valores (como,"{2,6,8,10}"). Apenas afeta quando algumas ASeries são plotadas no segundo eixo.
public string SecondCategoryData { get; set; }Valor da Propriedade
this[int]
Obtém o elemento Aspose.Cells.Charts.Series no índice especificado.
public Series this[int index] { get; }Valor da Propriedade
Métodos
Add(string, bool)
Adiciona a coleção Aspose.Cells.Charts.Series a um gráfico.
public int Add(string area, bool isVertical)Parâmetros
area string
Especifica os valores a partir dos quais plotar a série de dados
isVertical bool
Especifica se a série deve ser plotada a partir de um intervalo de valores de células por linha ou por coluna.
Retorna
Retorna o primeiro índice da ASeries adicionada no NSeries.
Observações
Se definir dados em células contíguas, use dois pontos para separá-las. Por exemplo, $C$2:$C$5.
Se definir dados em células não contíguas, use vírgula para separá-las. Por exemplo: ($C$2,$D$5).
Add(string, bool, bool)
Adiciona a coleção Aspose.Cells.Charts.Series a um gráfico.
public int Add(string area, bool isVertical, bool checkLabels)Parâmetros
area string
Especifica os valores a partir dos quais plotar a série de dados
isVertical bool
Especifica se a série deve ser plotada a partir de um intervalo de valores de células por linha ou por coluna.
checkLabels bool
Indica se o intervalo contém o nome da série
Retorna
Retorna o primeiro índice da ASeries adicionada no NSeries.
Observações
Se definir dados em células contíguas, use dois pontos para separá-las. Por exemplo, $C$2:$C$5.
Se definir dados em células não contíguas, use vírgula para separá-las. Por exemplo: ($C$2,$D$5).
AddR1C1(string, bool)
Adiciona a coleção Aspose.Cells.Charts.Series a um gráfico.
public int AddR1C1(string area, bool isVertical)Parâmetros
area string
Especifica os valores a partir dos quais plotar a série de dados
isVertical bool
Especifica se a série deve ser plotada a partir de um intervalo de valores de células por linha ou por coluna.
Retorna
Retorna o primeiro índice da ASeries adicionada no NSeries.
Observações
Se definir dados em células contíguas, use dois pontos para separá-las. Por exemplo, R[1]C[1]:R[3]C[2].
Se definir dados em células não contíguas, use vírgula para separá-las. Por exemplo,(R[1]C[1],R[3]C[2]).
Clear()
Limpa a coleção
public void Clear()GetSeriesByOrder(int)
Obtém o elemento Aspose.Cells.Charts.Series por ordem.
public Series GetSeriesByOrder(int order)Parâmetros
order int
A ordem da série
Retorna
O elemento série
RemoveAt(int)
Remove uma série no índice específico.
public void RemoveAt(int index)Parâmetros
index int
O índice.
SetSeriesNames(int, string, bool)
Define o nome de todas as séries no gráfico.
public void SetSeriesNames(int startIndex, string area, bool isVertical)Parâmetros
startIndex int
O índice da primeira série cuja você deseja definir o nome.
area string
Especifica a área para o nome da série.
isVertical bool
Especifica se a série deve ser plotada a partir de um intervalo de valores de células por linha ou por coluna.
Observações
Se o índice inicial for maior que a contagem das séries, ele retornará e não fará nada.
Se definir dados em células contíguas, use dois pontos para separá-las. Por exemplo, $C$2:$C$5.
Se definir dados em células não contíguas, use vírgula para separá-las. Por exemplo, ($C$2,$D$5).
SwapSeries(int, int)
Muda diretamente as ordens de duas séries.
public void SwapSeries(int sourceIndex, int destIndex)Parâmetros
sourceIndex int
O índice atual
destIndex int
O índice de destino
