Class Series
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Encapsula o objeto que representa uma única série de dados em um gráfico.
public class SeriesHerança
Membros Herdados
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 de "A1" a "B4"
int seriesIndex = chart.NSeries.Add("A1:B4", true);
//Definindo a fonte de dados para os dados de categoria do NSeries
chart.NSeries.CategoryData = "C1:C4";
Series series = chart.NSeries[seriesIndex];
//Definindo os valores da série.
series.Values = "=B1:B4";
//Mudando o tipo do gráfico da série.
series.Type = ChartType.Line;
//Definindo propriedades do marcador.
series.Marker.MarkerStyle = ChartMarkerType.Circle;
series.Marker.ForegroundColorSetType = FormattingType.Automatic;
series.Marker.ForegroundColor = System.Drawing.Color.Black;
series.Marker.BackgroundColorSetType = FormattingType.Automatic;
//realize seu negócio
//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 Int32 = 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 Int32 = 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 de "A1" a "B4"
Dim seriesIndex As Int32 = chart.NSeries.Add("A1:B4", True)
'Definindo a fonte de dados para os dados de categoria do NSeries
chart.NSeries.CategoryData = "C1:C4"
Dim series As Series = chart.NSeries(seriesIndex)
'Definindo os valores da série.
series.Values = "=B1:B4"
'Mudando o tipo do gráfico da série.
series.Type = ChartType.Line
'Definindo propriedades do marcador.
series.Marker.MarkerStyle = ChartMarkerType.Circle
series.Marker.ForegroundColorSetType = FormattingType.Automatic
series.Marker.ForegroundColor = System.Drawing.Color.Black
series.Marker.BackgroundColorSetType = FormattingType.Automatic
'Savando o arquivo Excel
workbook.Save("book1.xls")Propriedades
Area
Representa a área de fundo do objeto Series.
public Area Area { get; }Valor da Propriedade
Bar3DShapeType
Obtém ou define o tipo de forma 3D usado com o gráfico de barras ou colunas 3-D.
public Bar3DShapeType Bar3DShapeType { get; set; }Valor da Propriedade
Border
Representa a borda do objeto Series.
public Line Border { get; }Valor da Propriedade
BubbleScale
Obtém ou define o fator de escala para bolhas no grupo de gráficos especificado. Pode ser um valor inteiro de 0 (zero) a 300, correspondente a uma porcentagem do tamanho padrão. Aplica-se apenas a gráficos de bolhas.
public int BubbleScale { get; set; }Valor da Propriedade
BubbleSizes
Obtém ou define os valores dos tamanhos das bolhas da série de gráficos.
public string BubbleSizes { get; set; }Valor da Propriedade
CountOfDataValues
Obtém o número de valores de dados.
public int CountOfDataValues { get; }Valor da Propriedade
DataLabels
Representa o objeto DataLabels para o ASeries especificado.
public DataLabels DataLabels { get; }Valor da Propriedade
DisplayName
Obtém o nome da série que é exibido no gráfico.
public string DisplayName { get; }Valor da Propriedade
DoughnutHoleSize
Retorna ou define o tamanho do buraco em um grupo de gráficos de rosquinha. O tamanho do buraco é expresso como uma porcentagem do tamanho do gráfico, entre 10 e 90 por cento.
public int DoughnutHoleSize { get; set; }Valor da Propriedade
DownBars
Retorna um objeto Aspose.Cells.Charts.DropBars que representa as barras para baixo em um gráfico de linhas. Aplica-se apenas a gráficos de linhas.
public DropBars DownBars { get; }Valor da Propriedade
DropLines
Retorna um objeto Aspose.Cells.Drawing.Line que representa as linhas de queda para uma série em um gráfico de linhas ou gráfico de área. Aplica-se apenas a gráficos de linhas ou gráficos de área.
public Line DropLines { get; }Valor da Propriedade
Explosion
A distância de uma fatia de torta aberta do centro do gráfico de torta é expressa como uma porcentagem do diâmetro da torta.
public int Explosion { get; set; }Valor da Propriedade
FirstSliceAngle
Obtém ou define o ângulo da primeira fatia de gráfico de torta ou gráfico de rosquinha, em graus (horário a partir da vertical). Aplica-se apenas a gráficos de torta, torta 3-D e gráficos de rosquinha, de 0 a 360.
public short FirstSliceAngle { get; set; }Valor da Propriedade
GapWidth
Retorna ou define o espaço entre grupos de barras ou colunas, como uma porcentagem da largura da barra ou coluna. O valor desta propriedade deve estar entre 0 e 500.
public short GapWidth { get; set; }Valor da Propriedade
Has3DEffect
Verdadeiro se a série tiver uma aparência tridimensional. Aplica-se apenas a gráficos de bolhas.
public bool Has3DEffect { get; set; }Valor da Propriedade
HasDropLines
Verdadeiro se o gráfico tiver linhas de queda. Aplica-se apenas a gráficos de linhas ou gráficos de área.
public bool HasDropLines { get; set; }Valor da Propriedade
HasHiLoLines
Verdadeiro se o gráfico de linhas tiver linhas de alta-baixa. Aplica-se apenas a gráficos de linhas.
public bool HasHiLoLines { get; set; }Valor da Propriedade
HasLeaderLines
Verdadeiro se a série tiver linhas de líder.
public bool HasLeaderLines { get; set; }Valor da Propriedade
HasRadarAxisLabels
Verdadeiro se um gráfico de radar tiver rótulos de eixo de categoria. Aplica-se apenas a gráficos de radar.
public bool HasRadarAxisLabels { get; set; }Valor da Propriedade
HasSeriesLines
Verdadeiro se um gráfico de coluna empilhada ou gráfico de barras empilhadas tiver linhas de série ou se um gráfico de torta de torta ou gráfico de barras de torta tiver linhas de conectores entre as duas seções. Aplica-se apenas a gráficos de colunas empilhadas, gráficos de barras, gráficos de torta de torta ou gráficos de barras de torta.
public bool HasSeriesLines { get; set; }Valor da Propriedade
HasUpDownBars
Verdadeiro se um gráfico de linhas tiver barras para cima e para baixo. Aplica-se apenas a gráficos de linhas.
public bool HasUpDownBars { get; set; }Valor da Propriedade
HiLoLines
Retorna um objeto HiLoLines que representa as linhas alta-baixa para uma série em um gráfico de linhas. Aplica-se apenas a gráficos de linhas.
public Line HiLoLines { get; }Valor da Propriedade
IsAutoSplit
Indica se o valor do limite é automático.
public bool IsAutoSplit { get; }Valor da Propriedade
IsColorVaried
Representa se a cor dos pontos é variada. O gráfico deve conter apenas uma série.
public bool IsColorVaried { get; set; }Valor da Propriedade
IsFiltered
Indica se a série está selecionada ou filtrada. Verdadeiro representa que esta série está filtrada e não será exibida no gráfico.
public bool IsFiltered { get; set; }Valor da Propriedade
IsVerticalValues
Indica se a fonte de dados é vertical.
public bool IsVerticalValues { get; }Valor da Propriedade
LayoutProperties
Representa as propriedades de layout.
public SeriesLayoutProperties LayoutProperties { get; }Valor da Propriedade
LeaderLines
Representa linhas de líder em um gráfico. As linhas de líder conectam rótulos de dados a pontos de dados. Este objeto não é uma coleção; não há objeto que represente uma única linha de líder.
public Line LeaderLines { get; }Valor da Propriedade
LegendEntry
Obtém a entrada da legenda de acordo com esta série.
public LegendEntry LegendEntry { get; }Valor da Propriedade
Marker
Obtém o Aspose.Cells.Charts.Series.Marker?text=marcador.
public Marker Marker { get; }Valor da Propriedade
Name
Obtém ou define o nome da série de dados.
public string Name { get; set; }Valor da Propriedade
Exemplos
//Referenciando o nome a uma célula
chart.NSeries[0].Name = "=A1";
//Definindo uma string como nome
chart.NSeries[0].Name = "Primeira Série";'Referenciando o nome a uma célula
chart.NSeries[0].Name = "=A1"
'Definindo uma string como nome
chart.NSeries[0].Name = "Primeira Série"Overlap
Especifica como as barras e colunas são posicionadas. Pode ser um valor entre – 100 e 100. Aplica-se apenas a gráficos de barras 2-D e gráficos de colunas 2-D.
public short Overlap { get; set; }Valor da Propriedade
PlotOnSecondAxis
Indica se esta série é plotada no segundo eixo de valor.
public bool PlotOnSecondAxis { get; set; }Valor da Propriedade
Points
Obtém a coleção de pontos em uma série em um gráfico.
public ChartPointCollection Points { get; }Valor da Propriedade
Observações
Quando o gráfico é Pie of Pie ou Bar of Pie, o último ponto é outro ponto no primeiro gráfico de torta.
SecondPlotSize
Retorna ou define o tamanho da seção secundária de um gráfico de torta de torta ou gráfico de barras de torta, como uma porcentagem do tamanho da torta primária. Pode ser um valor de 5 a 200.
public short SecondPlotSize { get; set; }Valor da Propriedade
SeriesLines
Retorna um objeto SeriesLines que representa as linhas de série para um gráfico de barras empilhadas ou um gráfico de colunas empilhadas. Aplica-se apenas a gráficos de barras empilhadas e gráficos de colunas empilhadas.
public Line SeriesLines { get; }Valor da Propriedade
Shadow
Verdadeiro se a série tiver uma sombra.
public bool Shadow { get; set; }Valor da Propriedade
ShapeProperties
Obtém o objeto Aspose.Cells.Drawing.ShapePropertyCollection que contém as propriedades visuais de forma da Série.
public ShapePropertyCollection ShapeProperties { get; }Valor da Propriedade
ShowNegativeBubbles
Verdadeiro se bolhas negativas forem mostradas para o grupo de gráficos. Válido apenas para gráficos de bolhas.
public bool ShowNegativeBubbles { get; set; }Valor da Propriedade
SizeRepresents
Obtém ou define o que o tamanho da bolha representa em um gráfico de bolhas.
public BubbleSizeRepresents SizeRepresents { get; set; }Valor da Propriedade
Observações
BubbleSizeRepresents.SizeIsArea significa que o valor Aspose.Cells.Charts.Series.BubbleSizes é a área da bolha. BubbleSizeRepresents.SizeIsWidth significa que o valor Aspose.Cells.Charts.Series.BubbleSizes é a largura da bolha.
Smooth
Representa o suavização da curva. Verdadeiro se a suavização da curva estiver ativada para o gráfico de linhas ou gráfico de dispersão. Aplica-se apenas a gráficos de linhas e gráficos de dispersão conectados por linhas.
public bool Smooth { get; set; }Valor da Propriedade
SplitType
Retorna ou define um valor que determina quais pontos de dados estão na segunda torta ou barra em um gráfico de torta de torta ou gráfico de barras de torta.
public ChartSplitType SplitType { get; set; }Valor da Propriedade
SplitValue
Retorna ou define um valor que será usado para determinar quais pontos de dados estão na segunda torta ou barra em um gráfico de torta de torta ou gráfico de barras de torta.
public double SplitValue { get; set; }Valor da Propriedade
TrendLines
Retorna todas as linhas de tendência desta série.
public TrendlineCollection TrendLines { get; }Valor da Propriedade
Type
Obtém ou define o tipo de série de dados.
public ChartType Type { get; set; }Valor da Propriedade
UpBars
Retorna um objeto DropBars que representa as barras para cima em um gráfico de linhas. Aplica-se apenas a gráficos de linhas.
public DropBars UpBars { get; }Valor da Propriedade
Values
Representa os valores Y desta série de gráfico.
public string Values { get; set; }Valor da Propriedade
ValuesFormatCode
Representa o código de formato da lista de números de Values.
public string ValuesFormatCode { get; set; }Valor da Propriedade
XErrorBar
Representa a barra de erro na direção X da série.
public ErrorBar XErrorBar { get; }Valor da Propriedade
XValues
Representa os valores x da série de gráfico.
public string XValues { get; set; }Valor da Propriedade
XValuesFormatCode
Representa o código de formato da lista de números de X Values.
public string XValuesFormatCode { get; set; }Valor da Propriedade
YErrorBar
Representa a barra de erro na direção Y da série.
public ErrorBar YErrorBar { get; }Valor da Propriedade
Métodos
Move(int)
Move a série para cima ou para baixo.
public void Move(int count)Parâmetros
count int
O número de movimentos para cima ou para baixo. Move a série para cima se for menor que zero; Move a série para baixo se for maior que zero.
