Class SeriesCollection
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Encapsula una colección de objetos Aspose.Cells.Charts.Series.
public class SeriesCollection : CollectionBase<series>, IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerableHerencia
object ← CollectionBase<series> ← SeriesCollection
Implementa
IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerable
Miembros heredados
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()
Ejemplos
//Instanciando un objeto Workbook
Workbook workbook = new Workbook();
//Agregando una nueva hoja de trabajo al objeto Excel
int sheetIndex = workbook.Worksheets.Add();
//Obteniendo la referencia de la nueva hoja de trabajo agregada pasando su índice de hoja
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Agregando un valor de ejemplo a la celda "A1"
worksheet.Cells["A1"].PutValue(50);
//Agregando un valor de ejemplo a la celda "A2"
worksheet.Cells["A2"].PutValue(100);
//Agregando un valor de ejemplo a la celda "A3"
worksheet.Cells["A3"].PutValue(150);
//Agregando un valor de ejemplo a la celda "A4"
worksheet.Cells["A4"].PutValue(200);
//Agregando un valor de ejemplo a la celda "B1"
worksheet.Cells["B1"].PutValue(60);
//Agregando un valor de ejemplo a la celda "B2"
worksheet.Cells["B2"].PutValue(32);
//Agregando un valor de ejemplo a la celda "B3"
worksheet.Cells["B3"].PutValue(50);
//Agregando un valor de ejemplo a la celda "B4"
worksheet.Cells["B4"].PutValue(40);
//Agregando un valor de ejemplo a la celda "C1" como datos de categoría
worksheet.Cells["C1"].PutValue("Q1");
//Agregando un valor de ejemplo a la celda "C2" como datos de categoría
worksheet.Cells["C2"].PutValue("Q2");
//Agregando un valor de ejemplo a la celda "C3" como datos de categoría
worksheet.Cells["C3"].PutValue("Y1");
//Agregando un valor de ejemplo a la celda "C4" como datos de categoría
worksheet.Cells["C4"].PutValue("Y2");
//Agregando un gráfico a la hoja de trabajo
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//Accediendo a la instancia del gráfico recién agregado
Chart chart = worksheet.Charts[chartIndex];
//Agregando NSeries (fuente de datos del gráfico) al gráfico desde la celda "A1" hasta "B4"
chart.NSeries.Add("A1:B4", true);
//Estableciendo la fuente de datos para los datos de categoría de NSeries
chart.NSeries.CategoryData = "C1:C4";
//Guardando el archivo de Excel
workbook.Save("book1.xls");'Instanciando un objeto Workbook
Dim workbook As Workbook = New Workbook()
'Agregando una nueva hoja de trabajo al objeto Excel
Dim sheetIndex As Integer = workbook.Worksheets.Add()
'Obteniendo la referencia de la nueva hoja de trabajo agregada pasando su índice de hoja
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Agregando un valor de ejemplo a la celda "A1"
worksheet.Cells("A1").PutValue(50)
'Agregando un valor de ejemplo a la celda "A2"
worksheet.Cells("A2").PutValue(100)
'Agregando un valor de ejemplo a la celda "A3"
worksheet.Cells("A3").PutValue(150)
'Agregando un valor de ejemplo a la celda "A4"
worksheet.Cells("A4").PutValue(200)
'Agregando un valor de ejemplo a la celda "B1"
worksheet.Cells("B1").PutValue(60)
'Agregando un valor de ejemplo a la celda "B2"
worksheet.Cells("B2").PutValue(32)
'Agregando un valor de ejemplo a la celda "B3"
worksheet.Cells("B3").PutValue(50)
'Agregando un valor de ejemplo a la celda "B4"
worksheet.Cells("B4").PutValue(40)
'Agregando un valor de ejemplo a la celda "C1" como datos de categoría
worksheet.Cells("C1").PutValue("Q1")
'Agregando un valor de ejemplo a la celda "C2" como datos de categoría
worksheet.Cells("C2").PutValue("Q2")
'Agregando un valor de ejemplo a la celda "C3" como datos de categoría
worksheet.Cells("C3").PutValue("Y1")
'Agregando un valor de ejemplo a la celda "C4" como datos de categoría
worksheet.Cells("C4").PutValue("Y2")
'Agregando un gráfico a la hoja de trabajo
Dim chartIndex As Integer = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Accediendo a la instancia del gráfico recién agregado
Dim chart As Chart = worksheet.Charts(chartIndex)
'Agregando NSeries (fuente de datos del gráfico) al gráfico desde la celda "A1" hasta "B4"
chart.NSeries.Add("A1:B4", True)
'Estableciendo la fuente de datos para los datos de categoría de NSeries
chart.NSeries.CategoryData = "C1:C4"
'Guardando el archivo de Excel
workbook.Save("book1.xls")Propiedades
CategoryData
Obtiene o establece el rango de valores del eje de categoría. Puede ser un rango de celdas (como, “d1:e10”), o una secuencia de valores (como,"{2,6,8,10}").
public string CategoryData { get; set; }Valor de la propiedad
IsColorVaried
Representa si el color de los puntos es variado.
public bool IsColorVaried { get; set; }Valor de la propiedad
SecondCategoryData
Obtiene o establece el rango de valores del segundo eje de categoría. Puede ser un rango de celdas (como, “d1:e10”), o una secuencia de valores (como,"{2,6,8,10}"). Solo tiene efecto cuando algunas ASeries se grafican en el segundo eje.
public string SecondCategoryData { get; set; }Valor de la propiedad
this[int]
Obtiene el elemento Aspose.Cells.Charts.Series en el índice especificado.
public Series this[int index] { get; }Valor de la propiedad
Métodos
Add(string, bool)
Agrega la colección Aspose.Cells.Charts.Series a un gráfico.
public int Add(string area, bool isVertical)Parámetros
area string
Especifica los valores de los cuales graficar la serie de datos
isVertical bool
Especifica si graficar la serie desde un rango de valores de celdas por fila o por columna.
Retorna
Devuelve el primer índice de la ASeries agregada en la NSeries.
Observaciones
Si se establece datos en celdas contiguas, use dos puntos para separarlas. Por ejemplo, $C$2:$C$5.
Si se establece datos en celdas no contiguas, use comas para separarlas. Por ejemplo: ($C$2,$D$5).
Add(string, bool, bool)
Agrega la colección Aspose.Cells.Charts.Series a un gráfico.
public int Add(string area, bool isVertical, bool checkLabels)Parámetros
area string
Especifica los valores de los cuales graficar la serie de datos
isVertical bool
Especifica si graficar la serie desde un rango de valores de celdas por fila o por columna.
checkLabels bool
Indica si el rango contiene el nombre de la serie
Retorna
Devuelve el primer índice de la ASeries agregada en la NSeries.
Observaciones
Si se establece datos en celdas contiguas, use dos puntos para separarlas. Por ejemplo, $C$2:$C$5.
Si se establece datos en celdas no contiguas, use comas para separarlas. Por ejemplo: ($C$2,$D$5).
AddR1C1(string, bool)
Agrega la colección Aspose.Cells.Charts.Series a un gráfico.
public int AddR1C1(string area, bool isVertical)Parámetros
area string
Especifica los valores de los cuales graficar la serie de datos
isVertical bool
Especifica si graficar la serie desde un rango de valores de celdas por fila o por columna.
Retorna
Devuelve el primer índice de la ASeries agregada en la NSeries.
Observaciones
Si se establece datos en celdas contiguas, use dos puntos para separarlas. Por ejemplo, R[1]C[1]:R[3]C[2].
Si se establece datos en celdas no contiguas, use comas para separarlas. Por ejemplo,(R[1]C[1],R[3]C[2]).
Clear()
Limpia la colección
public void Clear()GetSeriesByOrder(int)
Obtiene el elemento Aspose.Cells.Charts.Series por orden.
public Series GetSeriesByOrder(int order)Parámetros
order int
El orden de la serie
Retorna
El elemento de la serie
RemoveAt(int)
Elimina una serie en el índice específico.
public void RemoveAt(int index)Parámetros
index int
El índice.
SetSeriesNames(int, string, bool)
Establece el nombre de todas las series en el gráfico.
public void SetSeriesNames(int startIndex, string area, bool isVertical)Parámetros
startIndex int
El índice de la primera serie a la que desea establecer el nombre.
area string
Especifica el área para el nombre de la serie.
isVertical bool
Especifica si graficar la serie desde un rango de valores de celdas por fila o por columna.
Observaciones
Si el índice inicial es mayor que la cantidad de las series, no hará nada y devolverá.
Si se establece datos en celdas contiguas, use dos puntos para separarlas. Por ejemplo, $C$2:$C$5.
Si se establece datos en celdas no contiguas, use comas para separarlas. Por ejemplo, ($C$2,$D$5).
SwapSeries(int, int)
Cambia directamente el orden de las dos series.
public void SwapSeries(int sourceIndex, int destIndex)Parámetros
sourceIndex int
El índice actual
destIndex int
El índice destino
