Class Series
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Encapsula el objeto que representa una única serie de datos en un gráfico.
public class SeriesHerencia
Miembros heredados
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 hoja de trabajo recién agregada pasando su índice
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"
int seriesIndex = chart.NSeries.Add("A1:B4", true);
//Estableciendo la fuente de datos para los datos de categoría de NSeries
chart.NSeries.CategoryData = "C1:C4";
Series series = chart.NSeries[seriesIndex];
//Estableciendo los valores de la serie.
series.Values = "=B1:B4";
//Cambiando el tipo de gráfico de la serie.
series.Type = ChartType.Line;
//Estableciendo propiedades del marcador.
series.Marker.MarkerStyle = ChartMarkerType.Circle;
series.Marker.ForegroundColorSetType = FormattingType.Automatic;
series.Marker.ForegroundColor = System.Drawing.Color.Black;
series.Marker.BackgroundColorSetType = FormattingType.Automatic;
//realiza tu negocio
//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 Int32 = workbook.Worksheets.Add()
'Obteniendo la referencia de la hoja de trabajo recién agregada pasando su índice
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 Int32 = 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"
Dim seriesIndex As Int32 = chart.NSeries.Add("A1:B4", True)
'Estableciendo la fuente de datos para los datos de categoría de NSeries
chart.NSeries.CategoryData = "C1:C4"
Dim series As Series = chart.NSeries(seriesIndex)
'Estableciendo los valores de la serie.
series.Values = "=B1:B4"
'Cambiando el tipo de gráfico de la serie.
series.Type = ChartType.Line
'Estableciendo propiedades del marcador.
series.Marker.MarkerStyle = ChartMarkerType.Circle
series.Marker.ForegroundColorSetType = FormattingType.Automatic
series.Marker.ForegroundColor = System.Drawing.Color.Black
series.Marker.BackgroundColorSetType = FormattingType.Automatic
'Guardando el archivo de Excel
workbook.Save("book1.xls")Propiedades
Área
Representa el área de fondo del objeto Series.
public Area Area { get; }Valor de la propiedad
Bar3DShapeType
Obtiene o establece el tipo de forma 3D utilizado con el gráfico de barras o columnas 3D.
public Bar3DShapeType Bar3DShapeType { get; set; }Valor de la propiedad
Borde
Representa el borde del objeto Series.
public Line Border { get; }Valor de la propiedad
BubbleScale
Obtiene o establece el factor de escala para las burbujas en el grupo de gráficos especificado. Puede ser un valor entero de 0 (cero) a 300, correspondiente a un porcentaje del tamaño predeterminado. Aplica solo a gráficos de burbujas.
public int BubbleScale { get; set; }Valor de la propiedad
BubbleSizes
Obtiene o establece los valores de tamaños de burbujas de la serie de gráficos.
public string BubbleSizes { get; set; }Valor de la propiedad
CountOfDataValues
Obtiene el número de valores de datos.
public int CountOfDataValues { get; }Valor de la propiedad
DataLabels
Representa el objeto DataLabels para el ASeries especificado.
public DataLabels DataLabels { get; }Valor de la propiedad
DisplayName
Obtiene el nombre de la serie que se muestra en el gráfico.
public string DisplayName { get; }Valor de la propiedad
DoughnutHoleSize
Devuelve o establece el tamaño del agujero en un grupo de gráficos de dona. El tamaño del agujero se expresa como un porcentaje del tamaño del gráfico, entre 10 y 90 por ciento.
public int DoughnutHoleSize { get; set; }Valor de la propiedad
DownBars
Devuelve un objeto Aspose.Cells.Charts.DropBars que representa las barras hacia abajo en un gráfico de líneas. Aplica solo a gráficos de líneas.
public DropBars DownBars { get; }Valor de la propiedad
DropLines
Devuelve un objeto Aspose.Cells.Drawing.Line que representa las líneas de caída para una serie en el gráfico de líneas o gráfico de área. Aplica solo a gráficos de líneas o gráficos de área.
public Line DropLines { get; }Valor de la propiedad
Explosion
La distancia de una porción de tarta abierta desde el centro del gráfico de tarta se expresa como un porcentaje del diámetro de la tarta.
public int Explosion { get; set; }Valor de la propiedad
FirstSliceAngle
Obtiene o establece el ángulo de la primera porción de gráfico de tarta o gráfico de dona, en grados (en sentido horario desde la vertical). Aplica solo a gráficos de tarta, tarta 3D y gráficos de dona, 0 a 360.
public short FirstSliceAngle { get; set; }Valor de la propiedad
GapWidth
Devuelve o establece el espacio entre grupos de barras o columnas, como un porcentaje del ancho de la barra o columna. El valor de esta propiedad debe estar entre 0 y 500.
public short GapWidth { get; set; }Valor de la propiedad
Has3DEffect
Verdadero si la serie tiene una apariencia tridimensional. Aplica solo a gráficos de burbujas.
public bool Has3DEffect { get; set; }Valor de la propiedad
HasDropLines
Verdadero si el gráfico tiene líneas de caída. Aplica solo a gráficos de líneas o gráficos de área.
public bool HasDropLines { get; set; }Valor de la propiedad
HasHiLoLines
Verdadero si el gráfico de líneas tiene líneas de alto-bajo. Aplica solo a gráficos de líneas.
public bool HasHiLoLines { get; set; }Valor de la propiedad
HasLeaderLines
Verdadero si la serie tiene líneas de líder.
public bool HasLeaderLines { get; set; }Valor de la propiedad
HasRadarAxisLabels
Verdadero si un gráfico de radar tiene etiquetas de eje de categoría. Aplica solo a gráficos de radar.
public bool HasRadarAxisLabels { get; set; }Valor de la propiedad
HasSeriesLines
Verdadero si un gráfico de columnas apiladas o gráfico de barras apiladas tiene líneas de serie o si un gráfico de Tarta de Tarta o gráfico de Barra de Tarta tiene líneas de conector entre las dos secciones. Aplica solo a gráficos de columnas apiladas, gráficos de barras apiladas, gráficos de Tarta de Tarta o gráficos de Barra de Tarta.
public bool HasSeriesLines { get; set; }Valor de la propiedad
HasUpDownBars
Verdadero si un gráfico de líneas tiene barras hacia arriba y hacia abajo. Aplica solo a gráficos de líneas.
public bool HasUpDownBars { get; set; }Valor de la propiedad
HiLoLines
Devuelve un objeto HiLoLines que representa las líneas de alto-bajo para una serie en un gráfico de líneas. Aplica solo a gráficos de líneas.
public Line HiLoLines { get; }Valor de la propiedad
IsAutoSplit
Indica si el valor umbral es automático.
public bool IsAutoSplit { get; }Valor de la propiedad
IsColorVaried
Representa si el color de los puntos varía. El gráfico debe contener solo una serie.
public bool IsColorVaried { get; set; }Valor de la propiedad
IsFiltered
Indica si la serie está seleccionada o filtrada. Verdadero representa que esta serie está filtrada, y no se mostrará en el gráfico.
public bool IsFiltered { get; set; }Valor de la propiedad
IsVerticalValues
Indica si la fuente de datos es vertical.
public bool IsVerticalValues { get; }Valor de la propiedad
LayoutProperties
Representa las propiedades de diseño.
public SeriesLayoutProperties LayoutProperties { get; }Valor de la propiedad
LeaderLines
Representa líneas de líder en un gráfico. Las líneas de líder conectan etiquetas de datos a puntos de datos. Este objeto no es una colección; no hay un objeto que represente una única línea de líder.
public Line LeaderLines { get; }Valor de la propiedad
LegendEntry
Obtiene la entrada de leyenda según esta serie.
public LegendEntry LegendEntry { get; }Valor de la propiedad
Marker
Obtiene el Aspose.Cells.Charts.Series.Marker?text=marker.
public Marker Marker { get; }Valor de la propiedad
Name
Obtiene o establece el nombre de la serie de datos.
public string Name { get; set; }Valor de la propiedad
Ejemplos
//Referencia de nombre a una celda
chart.NSeries[0].Name = "=A1";
//Establecer una cadena como nombre
chart.NSeries[0].Name = "Primera Serie";'Referencia de nombre a una celda
chart.NSeries[0].Name = "=A1"
'Establecer una cadena como nombre
chart.NSeries[0].Name = "Primera Serie"Overlap
Especifica cómo se posicionan las barras y columnas. Puede ser un valor entre – 100 y 100. Aplica solo a gráficos de barras 2D y gráficos de columnas 2D.
public short Overlap { get; set; }Valor de la propiedad
PlotOnSecondAxis
Indica si esta serie se traza en el segundo eje de valores.
public bool PlotOnSecondAxis { get; set; }Valor de la propiedad
Points
Obtiene la colección de puntos en una serie en un gráfico.
public ChartPointCollection Points { get; }Valor de la propiedad
Observaciones
Cuando el gráfico es Tarta de Tarta o Barra de Tarta, el último punto es otro punto en la primera trama de tarta.
SecondPlotSize
Devuelve o establece el tamaño de la sección secundaria de un gráfico de tarta de tarta o gráfico de barra de tarta, como un porcentaje del tamaño de la tarta primaria. Puede ser un valor de 5 a 200.
public short SecondPlotSize { get; set; }Valor de la propiedad
SeriesLines
Devuelve un objeto SeriesLines que representa las líneas de serie para un gráfico de barras apiladas o un gráfico de columnas apiladas. Aplica solo a gráficos de barras apiladas y gráficos de columnas apiladas.
public Line SeriesLines { get; }Valor de la propiedad
Shadow
Verdadero si la serie tiene una sombra.
public bool Shadow { get; set; }Valor de la propiedad
ShapeProperties
Obtiene el objeto Aspose.Cells.Drawing.ShapePropertyCollection que contiene las propiedades visuales de la forma de la Serie.
public ShapePropertyCollection ShapeProperties { get; }Valor de la propiedad
ShowNegativeBubbles
Verdadero si se muestran burbujas negativas para el grupo de gráficos. Válido solo para gráficos de burbujas.
public bool ShowNegativeBubbles { get; set; }Valor de la propiedad
SizeRepresents
Obtiene o establece lo que representa el tamaño de la burbuja en un gráfico de burbujas.
public BubbleSizeRepresents SizeRepresents { get; set; }Valor de la propiedad
Observaciones
BubbleSizeRepresents.SizeIsArea significa que el valor Aspose.Cells.Charts.Series.BubbleSizes es el área de la burbuja. BubbleSizeRepresents.SizeIsWidth significa que el valor Aspose.Cells.Charts.Series.BubbleSizes es el ancho de la burbuja.
Smooth
Representa el suavizado de curvas. Verdadero si el suavizado de curvas está activado para el gráfico de líneas o gráfico de dispersión. Aplica solo a gráficos de líneas y dispersión conectados por gráficos de líneas.
public bool Smooth { get; set; }Valor de la propiedad
SplitType
Devuelve o establece un valor que determina cómo identificar qué puntos de datos están en la segunda tarta o barra en un gráfico de tarta de tarta o gráfico de barra de tarta.
public ChartSplitType SplitType { get; set; }Valor de la propiedad
SplitValue
Devuelve o establece un valor que se utilizará para determinar qué puntos de datos están en la segunda tarta o barra en un gráfico de tarta de tarta o gráfico de barra de tarta.
public double SplitValue { get; set; }Valor de la propiedad
TrendLines
Devuelve todas las líneas de tendencia de esta serie.
public TrendlineCollection TrendLines { get; }Valor de la propiedad
Type
Obtiene o establece el tipo de una serie de datos.
public ChartType Type { get; set; }Valor de la propiedad
UpBars
Devuelve un objeto DropBars que representa las barras hacia arriba en un gráfico de líneas. Aplica solo a gráficos de líneas.
public DropBars UpBars { get; }Valor de la propiedad
Values
Representa los valores Y de esta serie de gráficos.
public string Values { get; set; }Valor de la propiedad
ValuesFormatCode
Representa el código de formato de la lista de números de Values.
public string ValuesFormatCode { get; set; }Valor de la propiedad
XErrorBar
Representa la barra de error en dirección X de la serie.
public ErrorBar XErrorBar { get; }Valor de la propiedad
XValues
Representa los valores x de la serie de gráficos.
public string XValues { get; set; }Valor de la propiedad
XValuesFormatCode
Representa el código de formato de la lista de números de X Values.
public string XValuesFormatCode { get; set; }Valor de la propiedad
YErrorBar
Representa la barra de error en dirección Y de la serie.
public ErrorBar YErrorBar { get; }Valor de la propiedad
Métodos
Move(int)
Mueve la serie hacia arriba o hacia abajo.
public void Move(int count)Parámetros
count int
El número de movimientos hacia arriba o hacia abajo. Mueve la serie hacia arriba si este es menor que cero; Mueve la serie hacia abajo si este es mayor que cero.
