Series

Series class

Encapsula el objeto que representa una sola serie de datos en un gráfico.

public class Series

Propiedades

NombreDescripción
Area { get; }Representa el área de fondo del objeto Serie.
Bar3DShapeType { get; set; }Obtiene o establece el tipo de forma 3D utilizado con el gráfico de barras o columnas 3D.
Border { get; }Representa el borde del objeto Serie.
BubbleScale { get; set; }Obtiene o establece el factor de escala de las burbujas en el grupo de gráfico especificado. Puede ser un valor entero de 0 (cero) a 300, corresponde a un porcentaje del tamaño predeterminado. Se aplica solo a gráficos de burbujas.
BubbleSizes { get; set; }Obtiene o establece los valores de tamaño de burbuja de la serie del gráfico.
CountOfDataValues { get; }Obtiene el número de valores de datos.
DataLabels { get; }Representa el objeto DataLabels para el ASeries especificado.
DisplayName { get; }Obtiene el nombre de la serie que se muestra en el gráfico del gráfico.
DoughnutHoleSize { get; set; }Devuelve o establece el tamaño del agujero en un grupo de gráficos de anillos. El tamaño del agujero se expresa como un porcentaje del tamaño del gráfico, entre 10 y 90 por ciento.
DownBars { get; }Devuelve unDropBars objeto que representa las barras hacia abajo en un gráfico de líneas. Se aplica solo a gráficos de líneas.
DropLines { get; }Devuelve unLine objeto que representa las líneas de caída de una serie en el gráfico de líneas o el gráfico de áreas. Se aplica solo al gráfico de líneas o gráficos de áreas.
Explosion { get; set; }La distancia de un sector circular abierto desde el centro del gráfico circular se expresa como un porcentaje del diámetro circular.
FirstSliceAngle { get; set; }Obtiene o establece el ángulo del primer sector del gráfico circular o del gráfico de anillos, en grados (en el sentido de las agujas del reloj desde la vertical). Solo se aplica a gráficos circulares, circulares 3D y de anillos, de 0 a 360.
GapWidth { get; set; }Devuelve o establece el espacio entre grupos de barras o columnas, como porcentaje del ancho de la barra o columna. El valor de esta propiedad debe estar entre 0 y 500.
Has3DEffect { get; set; }Verdadero si la serie tiene apariencia tridimensional. Se aplica solo a gráficos de burbujas.
HasDropLines { get; set; }Verdadero si el gráfico tiene líneas desplegables. Se aplica solo a gráficos de líneas o de áreas.
HasHiLoLines { get; set; }Verdadero si el gráfico de líneas tiene líneas altas y bajas. Se aplica solo a gráficos de líneas.
HasLeaderLines { get; set; }Verdadero si la serie tiene líneas directrices.
HasRadarAxisLabels { get; set; }Verdadero si un gráfico de radar tiene etiquetas de eje de categoría. Se aplica solo a cartas de radar.
HasSeriesLines { get; set; }Verdadero si un gráfico de columnas apiladas o un gráfico de barras tiene líneas de serie o si un gráfico circular o un gráfico circular de barras tiene líneas conectoras entre las dos secciones. Solo se aplica a gráficos de columnas apiladas, gráficos de barras, gráficos circulares o gráficos circulares de barras.
HasUpDownBars { get; set; }Verdadero si un gráfico de líneas tiene barras hacia arriba y hacia abajo. Se aplica solo a gráficos de líneas.
HiLoLines { get; }Devuelve un objeto HiLoLines que representa las líneas máximas y mínimas de una serie en un gráfico de líneas. Se aplica solo a gráficos de líneas.
IsAutoSplit { get; }Indica si el valor del umbral es automático.
IsColorVaried { get; set; }Representa si se varía el color de los puntos. El gráfico debe contener una sola serie.
IsVerticalValues { get; }Indica si la fuente de datos es vertical.
LayoutProperties { get; }Representa las propiedades del diseño.
LeaderLines { get; }Representa líneas guía en un gráfico. Las líneas guía conectan etiquetas de datos a puntos de datos. Este objeto no es una colección; no hay ningún objeto que represente una sola línea directriz.
LegendEntry { get; }Obtiene la entrada de la leyenda según esta serie.
Marker { get; }Obtiene elmarcador .
Name { get; set; }Obtiene o establece el nombre de la serie de datos.
Overlap { get; set; }Especifica cómo se colocan las barras y las columnas. Puede ser un valor entre – 100 y 100. Se aplica solo a gráficos de barras 2D y columnas 2D.
PlotOnSecondAxis { get; set; }Indica si esta serie se grafica en el segundo eje de valores.
Points { get; }Obtiene la colección de puntos de una serie en un gráfico.
SecondPlotSize { get; set; }Devuelve o establece el tamaño de la sección secundaria de un gráfico circular o de barras, como un porcentaje del tamaño del gráfico circular principal. Puede ser un valor de 5 a 200.
SeriesLines { get; }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. Se aplica solo a gráficos de barras apiladas y columnas apiladas.
Shadow { get; set; }Verdadero si la serie tiene sombra.
ShapeProperties { get; }Obtiene el objeto que contiene las propiedades de forma visual de Series.
ShowNegativeBubbles { get; set; }Verdadero si se muestran burbujas negativas para el grupo de gráficos. Válido solo para gráficos de burbujas.
SizeRepresents { get; set; }Obtiene o establece lo que representa el tamaño de la burbuja en un gráfico de burbujas.
Smooth { get; set; }Representa el suavizado de curvas. Verdadero si el suavizado de curvas está activado para el gráfico de líneas o el gráfico de dispersión. Se aplica solo a los gráficos de líneas y de dispersión conectados por gráficos de líneas.
SplitType { get; set; }Devuelve o establece un valor que determina qué puntos de datos se encuentran en el segundo gráfico circular o en la barra de un gráfico circular o en la barra de .
SplitValue { get; set; }Devuelve o establece un valor que se usará para determinar qué puntos de datos se encuentran en el segundo pastel o barra en un pastel de pastel o barra de gráfico circular.
TrendLines { get; }Devuelve un objeto que representa una colección de todas las líneas de tendencia de la serie.
Type { get; set; }Obtiene o establece el tipo de una serie de datos.
UpBars { get; }Devuelve un objeto DropBars que representa las barras hacia arriba en un gráfico de líneas. Se aplica solo a gráficos de líneas.
Values { get; set; }Representa los datos de la serie del gráfico.
ValuesFormatCode { get; set; }Representa el código de formato de la lista de números de Values.
XErrorBar { get; }Representa la barra de error de dirección X de la serie.
XValues { get; set; }Representa los valores x de la serie del gráfico.
YErrorBar { get; }Representa la barra de error de dirección Y de la serie.

Métodos

NombreDescripción
Move(int)Mueve la serie hacia arriba o hacia abajo.

Ejemplos


[C#]

// Instanciando un objeto Workbook
Workbook workbook = new Workbook();
//Agregar una nueva hoja de cálculo al objeto de Excel
int sheetIndex = workbook.Worksheets.Add();
//Obteniendo la referencia de la hoja de trabajo recién agregada pasando su índice de hoja
Worksheet worksheet = workbook.Worksheets[sheetIndex];
// Agregar un valor de muestra a la celda "A1"
worksheet.Cells["A1"].PutValue(50);
// Agregar un valor de muestra a la celda "A2"
worksheet.Cells["A2"].PutValue(100);
// Agregar un valor de muestra a la celda "A3"
worksheet.Cells["A3"].PutValue(150);
// Agregar un valor de muestra a la celda "A4"
worksheet.Cells["A4"].PutValue(200);
// Agregar un valor de muestra a la celda "B1"
worksheet.Cells["B1"].PutValue(60);
// Agregar un valor de muestra a la celda "B2"
worksheet.Cells["B2"].PutValue(32);
// Agregar un valor de muestra a la celda "B3"
worksheet.Cells["B3"].PutValue(50);
// Agregar un valor de muestra a la celda "B4"
worksheet.Cells["B4"].PutValue(40);
// Agregar un valor de muestra a la celda "C1" como datos de categoría
worksheet.Cells["C1"].PutValue("Q1");
// Agregar un valor de muestra a la celda "C2" como datos de categoría
worksheet.Cells["C2"].PutValue("Q2");
// Agregar un valor de muestra a la celda "C3" como datos de categoría
worksheet.Cells["C3"].PutValue("Y1");
// Agregar un valor de muestra a la celda "C4" como datos de categoría
worksheet.Cells["C4"].PutValue("Y2");
//Añadiendo 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];
// Agregar NSeries (fuente de datos del gráfico) al gráfico que va desde la celda "A1" hasta la celda "B4"
int seriesIndex = chart.NSeries.Add("A1:B4", true);
//Configuración de la fuente de datos para la categoría de datos 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;
//Configuración de las 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;

//haz tu negocio

//Guardando el archivo de Excel
workbook.Save("book1.xls");

[Visual Basic]

'Crear una instancia de un objeto Workbook
Dim workbook As Workbook = New Workbook()
'Agregar una nueva hoja de cálculo al objeto de Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Obtener la referencia de la hoja de trabajo recién agregada pasando su índice de hoja
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Adding a sample value to "A1" cell
worksheet.Cells("A1").PutValue(50)
'Adding a sample value to "A2" cell
worksheet.Cells("A2").PutValue(100)
'Adding a sample value to "A3" cell
worksheet.Cells("A3").PutValue(150)
'Adding a sample value to "A4" cell
worksheet.Cells("A4").PutValue(200)
'Adding a sample value to "B1" cell
worksheet.Cells("B1").PutValue(60)
'Adding a sample value to "B2" cell
worksheet.Cells("B2").PutValue(32)
'Adding a sample value to "B3" cell
worksheet.Cells("B3").PutValue(50)
'Adding a sample value to "B4" cell
worksheet.Cells("B4").PutValue(40)
'Adding a sample value to "C1" cell as category data
worksheet.Cells("C1").PutValue("Q1")
'Adding a sample value to "C2" cell as category data
worksheet.Cells("C2").PutValue("Q2")
'Adding a sample value to "C3" cell as category data
worksheet.Cells("C3").PutValue("Y1")
'Adding a sample value to "C4" cell as category data
worksheet.Cells("C4").PutValue("Y2")
'Adición de un gráfico a la hoja de cálculo
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Acceso a la instancia del gráfico recién agregado
Dim chart As Chart = worksheet.Charts(chartIndex)
'Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B4"
Dim seriesIndex As Int32 = chart.NSeries.Add("A1:B4", True)
'Configuración de la fuente de datos para los datos de categoría de NSeries
chart.NSeries.CategoryData = "C1:C4"
Dim series As Series = chart.NSeries(seriesIndex)
'Configuración de los valores de la serie.
series.Values = "=B1:B4"
'Cambiar el tipo de gráfico de la serie.
series.Type = ChartType.Line
'Configuración de las 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
'Guardar el archivo de Excel
workbook.Save("book1.xls")

Ver también