Class Series
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Incapsula l’oggetto che rappresenta una singola serie di dati in un grafico.
public class Series
Ereditarietà
Membri Ereditati
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Esempi
//Creazione di un oggetto Workbook
Workbook workbook = new Workbook();
//Aggiunta di un nuovo foglio di lavoro all'oggetto Excel
int sheetIndex = workbook.Worksheets.Add();
//Ottenimento del riferimento del foglio di lavoro appena aggiunto passando il suo indice
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Aggiunta di un valore di esempio alla cella "A1"
worksheet.Cells["A1"].PutValue(50);
//Aggiunta di un valore di esempio alla cella "A2"
worksheet.Cells["A2"].PutValue(100);
//Aggiunta di un valore di esempio alla cella "A3"
worksheet.Cells["A3"].PutValue(150);
//Aggiunta di un valore di esempio alla cella "A4"
worksheet.Cells["A4"].PutValue(200);
//Aggiunta di un valore di esempio alla cella "B1"
worksheet.Cells["B1"].PutValue(60);
//Aggiunta di un valore di esempio alla cella "B2"
worksheet.Cells["B2"].PutValue(32);
//Aggiunta di un valore di esempio alla cella "B3"
worksheet.Cells["B3"].PutValue(50);
//Aggiunta di un valore di esempio alla cella "B4"
worksheet.Cells["B4"].PutValue(40);
//Aggiunta di un valore di esempio alla cella "C1" come dati di categoria
worksheet.Cells["C1"].PutValue("Q1");
//Aggiunta di un valore di esempio alla cella "C2" come dati di categoria
worksheet.Cells["C2"].PutValue("Q2");
//Aggiunta di un valore di esempio alla cella "C3" come dati di categoria
worksheet.Cells["C3"].PutValue("Y1");
//Aggiunta di un valore di esempio alla cella "C4" come dati di categoria
worksheet.Cells["C4"].PutValue("Y2");
//Aggiunta di un grafico al foglio di lavoro
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//Accesso all'istanza del grafico appena aggiunto
Chart chart = worksheet.Charts[chartIndex];
//Aggiunta di NSeries (sorgente dati del grafico) al grafico che va dalla cella "A1" alla cella "B4"
int seriesIndex = chart.NSeries.Add("A1:B4", true);
//Impostazione della sorgente dati per i dati di categoria di NSeries
chart.NSeries.CategoryData = "C1:C4";
Series series = chart.NSeries[seriesIndex];
//Impostazione dei valori della serie.
series.Values = "=B1:B4";
//Modifica del tipo di grafico della serie.
series.Type = ChartType.Line;
//Impostazione delle proprietà del marcatore.
series.Marker.MarkerStyle = ChartMarkerType.Circle;
series.Marker.ForegroundColorSetType = FormattingType.Automatic;
series.Marker.ForegroundColor = System.Drawing.Color.Black;
series.Marker.BackgroundColorSetType = FormattingType.Automatic;
//esegui la tua logica
//Salvataggio del file Excel
workbook.Save("book1.xls");
'Creazione di un oggetto Workbook
Dim workbook As Workbook = New Workbook()
'Aggiunta di un nuovo foglio di lavoro all'oggetto Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Ottenimento del riferimento del foglio di lavoro appena aggiunto passando il suo indice
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Aggiunta di un valore di esempio alla cella "A1"
worksheet.Cells("A1").PutValue(50)
'Aggiunta di un valore di esempio alla cella "A2"
worksheet.Cells("A2").PutValue(100)
'Aggiunta di un valore di esempio alla cella "A3"
worksheet.Cells("A3").PutValue(150)
'Aggiunta di un valore di esempio alla cella "A4"
worksheet.Cells("A4").PutValue(200)
'Aggiunta di un valore di esempio alla cella "B1"
worksheet.Cells("B1").PutValue(60)
'Aggiunta di un valore di esempio alla cella "B2"
worksheet.Cells("B2").PutValue(32)
'Aggiunta di un valore di esempio alla cella "B3"
worksheet.Cells("B3").PutValue(50)
'Aggiunta di un valore di esempio alla cella "B4"
worksheet.Cells("B4").PutValue(40)
'Aggiunta di un valore di esempio alla cella "C1" come dati di categoria
worksheet.Cells("C1").PutValue("Q1")
'Aggiunta di un valore di esempio alla cella "C2" come dati di categoria
worksheet.Cells("C2").PutValue("Q2")
'Aggiunta di un valore di esempio alla cella "C3" come dati di categoria
worksheet.Cells("C3").PutValue("Y1")
'Aggiunta di un valore di esempio alla cella "C4" come dati di categoria
worksheet.Cells("C4").PutValue("Y2")
'Aggiunta di un grafico al foglio di lavoro
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Accesso all'istanza del grafico appena aggiunto
Dim chart As Chart = worksheet.Charts(chartIndex)
'Aggiunta di NSeries (sorgente dati del grafico) al grafico che va dalla cella "A1" alla cella "B4"
Dim seriesIndex As Int32 = chart.NSeries.Add("A1:B4", True)
'Impostazione della sorgente dati per i dati di categoria di NSeries
chart.NSeries.CategoryData = "C1:C4"
Dim series As Series = chart.NSeries(seriesIndex)
'Impostazione dei valori della serie.
series.Values = "=B1:B4"
'Modifica del tipo di grafico della serie.
series.Type = ChartType.Line
'Impostazione delle proprietà del marcatore.
series.Marker.MarkerStyle = ChartMarkerType.Circle
series.Marker.ForegroundColorSetType = FormattingType.Automatic
series.Marker.ForegroundColor = System.Drawing.Color.Black
series.Marker.BackgroundColorSetType = FormattingType.Automatic
'Salvataggio del file Excel
workbook.Save("book1.xls")
Proprietà
Area
Rappresenta l’area di sfondo dell’oggetto Series.
public Area Area { get; }
Valore della Proprietà
Bar3DShapeType
Ottiene o imposta il tipo di forma 3D utilizzato con il grafico a barre o colonne 3-D.
public Bar3DShapeType Bar3DShapeType { get; set; }
Valore della Proprietà
Border
Rappresenta il bordo dell’oggetto Series.
public Line Border { get; }
Valore della Proprietà
BubbleScale
Ottiene o imposta il fattore di scala per le bolle nel gruppo di grafici specificato. Può essere un valore intero da 0 (zero) a 300, corrispondente a una percentuale della dimensione predefinita. Si applica solo ai grafici a bolle.
public int BubbleScale { get; set; }
Valore della Proprietà
BubbleSizes
Ottiene o imposta i valori delle dimensioni delle bolle della serie del grafico.
public string BubbleSizes { get; set; }
Valore della Proprietà
CountOfDataValues
Ottiene il numero dei valori dei dati.
public int CountOfDataValues { get; }
Valore della Proprietà
DataLabels
Rappresenta l’oggetto DataLabels per la specifica ASeries.
public DataLabels DataLabels { get; }
Valore della Proprietà
DisplayName
Ottiene il nome della serie che viene visualizzato sul grafico.
public string DisplayName { get; }
Valore della Proprietà
DoughnutHoleSize
Restituisce o imposta la dimensione del foro in un gruppo di grafici a ciambella. La dimensione del foro è espressa come una percentuale della dimensione del grafico, tra il 10 e il 90 percento.
public int DoughnutHoleSize { get; set; }
Valore della Proprietà
DownBars
Restituisce un oggetto Aspose.Cells.Charts.DropBars che rappresenta le barre inferiori su un grafico a linee. Si applica solo ai grafici a linee.
public DropBars DownBars { get; }
Valore della Proprietà
DropLines
Restituisce un oggetto Aspose.Cells.Drawing.Line che rappresenta le linee di caduta per una serie su un grafico a linee o a aree. Si applica solo a grafici a linee o a grafici a aree.
public Line DropLines { get; }
Valore della Proprietà
Explosion
La distanza di una fetta di torta aperta dal centro del grafico a torta è espressa come una percentuale del diametro della torta.
public int Explosion { get; set; }
Valore della Proprietà
FirstSliceAngle
Ottiene o imposta l’angolo della prima fetta di grafico a torta o ciambella, in gradi (in senso orario rispetto alla verticale). Si applica solo a grafici a torta, a torta 3-D e a ciambella, da 0 a 360.
public short FirstSliceAngle { get; set; }
Valore della Proprietà
GapWidth
Restituisce o imposta lo spazio tra i gruppi di barre o colonne, come percentuale della larghezza della barra o della colonna. Il valore di questa proprietà deve essere compreso tra 0 e 500.
public short GapWidth { get; set; }
Valore della Proprietà
Has3DEffect
Vero se la serie ha un aspetto tridimensionale. Si applica solo a grafici a bolle.
public bool Has3DEffect { get; set; }
Valore della Proprietà
HasDropLines
Vero se il grafico ha linee di caduta. Si applica solo a grafici a linee o a grafici a aree.
public bool HasDropLines { get; set; }
Valore della Proprietà
HasHiLoLines
Vero se il grafico a linee ha linee alte-basse. Si applica solo a grafici a linee.
public bool HasHiLoLines { get; set; }
Valore della Proprietà
HasLeaderLines
Vero se la serie ha linee di collegamento.
public bool HasLeaderLines { get; set; }
Valore della Proprietà
HasRadarAxisLabels
Vero se un grafico radar ha etichette degli assi di categoria. Si applica solo a grafici radar.
public bool HasRadarAxisLabels { get; set; }
Valore della Proprietà
HasSeriesLines
Vero se un grafico a colonne impilate o a barre impilate ha linee di serie o se un grafico a torta di torta o a barre di torta ha linee di collegamento tra le due sezioni. Si applica solo a grafici a colonne impilate, grafici a barre impilate, grafici a torta di torta o grafici a barre di torta.
public bool HasSeriesLines { get; set; }
Valore della Proprietà
HasUpDownBars
Vero se un grafico a linee ha barre su e giù. Si applica solo a grafici a linee.
public bool HasUpDownBars { get; set; }
Valore della Proprietà
HiLoLines
Restituisce un oggetto HiLoLines che rappresenta le linee alte-basse per una serie su un grafico a linee. Si applica solo a grafici a linee.
public Line HiLoLines { get; }
Valore della Proprietà
IsAutoSplit
Indica se il valore di soglia è automatico.
public bool IsAutoSplit { get; }
Valore della Proprietà
IsColorVaried
Rappresenta se il colore dei punti è variato. Il grafico deve contenere solo una serie.
public bool IsColorVaried { get; set; }
Valore della Proprietà
IsFiltered
Indica se la serie è selezionata o filtrata. Vero rappresenta che questa serie è filtrata e non verrà visualizzata nel grafico.
public bool IsFiltered { get; set; }
Valore della Proprietà
IsVerticalValues
Indica se la sorgente dati è verticale.
public bool IsVerticalValues { get; }
Valore della Proprietà
LayoutProperties
Rappresenta le proprietà di layout.
public SeriesLayoutProperties LayoutProperties { get; }
Valore della Proprietà
LeaderLines
Rappresenta le linee di collegamento su un grafico. Le linee di collegamento collegano le etichette dei dati ai punti dati. Questo oggetto non è una collezione; non esiste un oggetto che rappresenta una singola linea di collegamento.
public Line LeaderLines { get; }
Valore della Proprietà
LegendEntry
Ottiene l’entry della legenda secondo questa serie.
public LegendEntry LegendEntry { get; }
Valore della Proprietà
Marker
Ottiene il Aspose.Cells.Charts.Series.Marker?text=marcatore.
public Marker Marker { get; }
Valore della Proprietà
Name
Ottiene o imposta il nome della serie di dati.
public string Name { get; set; }
Valore della Proprietà
Esempi
//Riferimento nome a una cella
chart.NSeries[0].Name = "=A1";
//Imposta una stringa come nome
chart.NSeries[0].Name = "Prima Serie";
'Riferimento nome a una cella
chart.NSeries[0].Name = "=A1"
'Imposta una stringa come nome
chart.NSeries[0].Name = "Prima Serie"
Overlap
Specifica come sono posizionate le barre e le colonne. Può essere un valore compreso tra -100 e 100. Si applica solo a grafici a barre 2-D e a grafici a colonne 2-D.
public short Overlap { get; set; }
Valore della Proprietà
PlotOnSecondAxis
Indica se questa serie è tracciata sul secondo asse dei valori.
public bool PlotOnSecondAxis { get; set; }
Valore della Proprietà
Points
Ottiene la collezione di punti in una serie in un grafico.
public ChartPointCollection Points { get; }
Valore della Proprietà
Osservazioni
Quando il grafico è una torta di torta o una barre di torta, l’ultimo punto è un altro punto nel primo grafico a torta.
SecondPlotSize
Restituisce o imposta la dimensione della sezione secondaria di un grafico a torta di torta o di un grafico a barre di torta, come percentuale della dimensione della torta primaria. Può essere un valore da 5 a 200.
public short SecondPlotSize { get; set; }
Valore della Proprietà
SeriesLines
Restituisce un oggetto SeriesLines che rappresenta le linee di serie per un grafico a barre impilate o per un grafico a colonne impilate. Si applica solo a grafici a barre impilate e a grafici a colonne impilate.
public Line SeriesLines { get; }
Valore della Proprietà
Shadow
Vero se la serie ha un’ombra.
public bool Shadow { get; set; }
Valore della Proprietà
ShapeProperties
Ottiene l’oggetto Aspose.Cells.Drawing.ShapePropertyCollection che contiene le proprietà visive della forma della Serie.
public ShapePropertyCollection ShapeProperties { get; }
Valore della Proprietà
ShowNegativeBubbles
Vero se le bolle negative sono mostrate per il gruppo di grafici. Valido solo per grafici a bolle.
public bool ShowNegativeBubbles { get; set; }
Valore della Proprietà
SizeRepresents
Ottiene o imposta cosa rappresenta la dimensione della bolla su un grafico a bolle.
public BubbleSizeRepresents SizeRepresents { get; set; }
Valore della Proprietà
Osservazioni
BubbleSizeRepresents.SizeIsArea significa che il valore Aspose.Cells.Charts.Series.BubbleSizes è l’area della bolla. BubbleSizeRepresents.SizeIsWidth significa che il valore Aspose.Cells.Charts.Series.BubbleSizes è la larghezza della bolla.
Smooth
Rappresenta l’ammorbidimento della curva. Vero se l’ammorbidimento della curva è attivato per il grafico a linee o il grafico a dispersione. Si applica solo a grafici a linee e a dispersioni collegati da linee.
public bool Smooth { get; set; }
Valore della Proprietà
SplitType
Restituisce o imposta un valore che determina come identificare quali punti dati sono nella seconda torta o barra in un grafico a torta di torta o a barre di torta.
public ChartSplitType SplitType { get; set; }
Valore della Proprietà
SplitValue
Restituisce o imposta un valore che sarà utilizzato per determinare quali punti dati sono nella seconda torta o barra in un grafico a torta di torta o a barre di torta.
public double SplitValue { get; set; }
Valore della Proprietà
TrendLines
Restituisce tutte le linee di tendenza di questa serie.
public TrendlineCollection TrendLines { get; }
Valore della Proprietà
Type
Ottiene o imposta il tipo di una serie di dati.
public ChartType Type { get; set; }
Valore della Proprietà
UpBars
Restituisce un oggetto DropBars che rappresenta le barre superiori su un grafico a linee. Si applica solo a grafici a linee.
public DropBars UpBars { get; }
Valore della Proprietà
Values
Rappresenta i valori Y di questa serie di grafici.
public string Values { get; set; }
Valore della Proprietà
ValuesFormatCode
Rappresenta il codice di formato della lista di numeri dei Values.
public string ValuesFormatCode { get; set; }
Valore della Proprietà
XErrorBar
Rappresenta la barra di errore in direzione X della serie.
public ErrorBar XErrorBar { get; }
Valore della Proprietà
XValues
Rappresenta i valori x della serie di grafici.
public string XValues { get; set; }
Valore della Proprietà
XValuesFormatCode
Rappresenta il codice di formato della lista di numeri dei valori X.
public string XValuesFormatCode { get; set; }
Valore della Proprietà
YErrorBar
Rappresenta la barra di errore in direzione Y della serie.
public ErrorBar YErrorBar { get; }
Valore della Proprietà
Metodi
Move(int)
Sposta la serie verso l’alto o verso il basso.
public void Move(int count)
Parametri
count
int
Il numero di spostamenti verso l’alto o verso il basso. Sposta la serie verso l’alto se questo è inferiore a zero; Sposta la serie verso il basso se questo è maggiore di zero.