Class Series

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à

objectSeries

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à

Area

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à

Bar3DShapeType

Border

Rappresenta il bordo dell’oggetto Series.

public Line Border { get; }

Valore della Proprietà

Line

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à

int

BubbleSizes

Ottiene o imposta i valori delle dimensioni delle bolle della serie del grafico.

public string BubbleSizes { get; set; }

Valore della Proprietà

string

CountOfDataValues

Ottiene il numero dei valori dei dati.

public int CountOfDataValues { get; }

Valore della Proprietà

int

DataLabels

Rappresenta l’oggetto DataLabels per la specifica ASeries.

public DataLabels DataLabels { get; }

Valore della Proprietà

DataLabels

DisplayName

Ottiene il nome della serie che viene visualizzato sul grafico.

public string DisplayName { get; }

Valore della Proprietà

string

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à

int

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à

DropBars

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à

Line

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à

int

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à

short

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à

short

Has3DEffect

Vero se la serie ha un aspetto tridimensionale. Si applica solo a grafici a bolle.

public bool Has3DEffect { get; set; }

Valore della Proprietà

bool

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à

bool

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à

bool

HasLeaderLines

Vero se la serie ha linee di collegamento.

public bool HasLeaderLines { get; set; }

Valore della Proprietà

bool

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à

bool

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à

bool

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à

bool

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à

Line

IsAutoSplit

Indica se il valore di soglia è automatico.

public bool IsAutoSplit { get; }

Valore della Proprietà

bool

IsColorVaried

Rappresenta se il colore dei punti è variato. Il grafico deve contenere solo una serie.

public bool IsColorVaried { get; set; }

Valore della Proprietà

bool

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à

bool

IsVerticalValues

Indica se la sorgente dati è verticale.

public bool IsVerticalValues { get; }

Valore della Proprietà

bool

LayoutProperties

Rappresenta le proprietà di layout.

public SeriesLayoutProperties LayoutProperties { get; }

Valore della Proprietà

SeriesLayoutProperties

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à

Line

LegendEntry

Ottiene l’entry della legenda secondo questa serie.

public LegendEntry LegendEntry { get; }

Valore della Proprietà

LegendEntry

Marker

Ottiene il Aspose.Cells.Charts.Series.Marker?text=marcatore.

public Marker Marker { get; }

Valore della Proprietà

Marker

Name

Ottiene o imposta il nome della serie di dati.

public string Name { get; set; }

Valore della Proprietà

string

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à

short

PlotOnSecondAxis

Indica se questa serie è tracciata sul secondo asse dei valori.

public bool PlotOnSecondAxis { get; set; }

Valore della Proprietà

bool

Points

Ottiene la collezione di punti in una serie in un grafico.

public ChartPointCollection Points { get; }

Valore della Proprietà

ChartPointCollection

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à

short

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à

Line

Shadow

Vero se la serie ha un’ombra.

public bool Shadow { get; set; }

Valore della Proprietà

bool

ShapeProperties

Ottiene l’oggetto Aspose.Cells.Drawing.ShapePropertyCollection che contiene le proprietà visive della forma della Serie.

public ShapePropertyCollection ShapeProperties { get; }

Valore della Proprietà

ShapePropertyCollection

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à

bool

SizeRepresents

Ottiene o imposta cosa rappresenta la dimensione della bolla su un grafico a bolle.

public BubbleSizeRepresents SizeRepresents { get; set; }

Valore della Proprietà

BubbleSizeRepresents

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à

bool

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à

ChartSplitType

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à

double

TrendLines

Restituisce tutte le linee di tendenza di questa serie.

public TrendlineCollection TrendLines { get; }

Valore della Proprietà

TrendlineCollection

Type

Ottiene o imposta il tipo di una serie di dati.

public ChartType Type { get; set; }

Valore della Proprietà

ChartType

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à

DropBars

Values

Rappresenta i valori Y di questa serie di grafici.

public string Values { get; set; }

Valore della Proprietà

string

ValuesFormatCode

Rappresenta il codice di formato della lista di numeri dei Values.

public string ValuesFormatCode { get; set; }

Valore della Proprietà

string

XErrorBar

Rappresenta la barra di errore in direzione X della serie.

public ErrorBar XErrorBar { get; }

Valore della Proprietà

ErrorBar

XValues

Rappresenta i valori x della serie di grafici.

public string XValues { get; set; }

Valore della Proprietà

string

XValuesFormatCode

Rappresenta il codice di formato della lista di numeri dei valori X.

public string XValuesFormatCode { get; set; }

Valore della Proprietà

string

YErrorBar

Rappresenta la barra di errore in direzione Y della serie.

public ErrorBar YErrorBar { get; }

Valore della Proprietà

ErrorBar

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.

 Italiano