Class Series
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Kapselt das Objekt, das eine einzelne Datenreihe in einem Diagramm darstellt.
public class SeriesVererbung
Vererbte Mitglieder
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Beispiele
//Instanziieren eines Workbook-Objekts
Workbook workbook = new Workbook();
//Hinzufügen eines neuen Arbeitsblatts zum Excel-Objekt
int sheetIndex = workbook.Worksheets.Add();
//Erhalten der Referenz des neu hinzugefügten Arbeitsblatts durch Übergeben seines Blattindex
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Hinzufügen eines Beispielwerts zur Zelle "A1"
worksheet.Cells["A1"].PutValue(50);
//Hinzufügen eines Beispielwerts zur Zelle "A2"
worksheet.Cells["A2"].PutValue(100);
//Hinzufügen eines Beispielwerts zur Zelle "A3"
worksheet.Cells["A3"].PutValue(150);
//Hinzufügen eines Beispielwerts zur Zelle "A4"
worksheet.Cells["A4"].PutValue(200);
//Hinzufügen eines Beispielwerts zur Zelle "B1"
worksheet.Cells["B1"].PutValue(60);
//Hinzufügen eines Beispielwerts zur Zelle "B2"
worksheet.Cells["B2"].PutValue(32);
//Hinzufügen eines Beispielwerts zur Zelle "B3"
worksheet.Cells["B3"].PutValue(50);
//Hinzufügen eines Beispielwerts zur Zelle "B4"
worksheet.Cells["B4"].PutValue(40);
//Hinzufügen eines Beispielwerts zur Zelle "C1" als Kategoriedaten
worksheet.Cells["C1"].PutValue("Q1");
//Hinzufügen eines Beispielwerts zur Zelle "C2" als Kategoriedaten
worksheet.Cells["C2"].PutValue("Q2");
//Hinzufügen eines Beispielwerts zur Zelle "C3" als Kategoriedaten
worksheet.Cells["C3"].PutValue("Y1");
//Hinzufügen eines Beispielwerts zur Zelle "C4" als Kategoriedaten
worksheet.Cells["C4"].PutValue("Y2");
//Hinzufügen eines Diagramms zum Arbeitsblatt
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//Zugriff auf die Instanz des neu hinzugefügten Diagramms
Chart chart = worksheet.Charts[chartIndex];
//Hinzufügen von NSeries (Diagramm-Datenquelle) zum Diagramm, das von der Zelle "A1" bis "B4" reicht
int seriesIndex = chart.NSeries.Add("A1:B4", true);
//Festlegen der Datenquelle für die Kategoriedaten von NSeries
chart.NSeries.CategoryData = "C1:C4";
Series series = chart.NSeries[seriesIndex];
//Festlegen der Werte der Serie.
series.Values = "=B1:B4";
//Ändern des Diagrammtyps der Serie.
series.Type = ChartType.Line;
//Festlegen der Marker-Eigenschaften.
series.Marker.MarkerStyle = ChartMarkerType.Circle;
series.Marker.ForegroundColorSetType = FormattingType.Automatic;
series.Marker.ForegroundColor = System.Drawing.Color.Black;
series.Marker.BackgroundColorSetType = FormattingType.Automatic;
//Führen Sie Ihre Geschäftslogik aus
//Speichern der Excel-Datei
workbook.Save("book1.xls");'Instanziieren eines Workbook-Objekts
Dim workbook As Workbook = New Workbook()
'Hinzufügen eines neuen Arbeitsblatts zum Excel-Objekt
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Erhalten der Referenz des neu hinzugefügten Arbeitsblatts durch Übergeben seines Blattindex
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Hinzufügen eines Beispielwerts zur Zelle "A1"
worksheet.Cells("A1").PutValue(50)
'Hinzufügen eines Beispielwerts zur Zelle "A2"
worksheet.Cells("A2").PutValue(100)
'Hinzufügen eines Beispielwerts zur Zelle "A3"
worksheet.Cells("A3").PutValue(150)
'Hinzufügen eines Beispielwerts zur Zelle "A4"
worksheet.Cells("A4").PutValue(200)
'Hinzufügen eines Beispielwerts zur Zelle "B1"
worksheet.Cells("B1").PutValue(60)
'Hinzufügen eines Beispielwerts zur Zelle "B2"
worksheet.Cells("B2").PutValue(32)
'Hinzufügen eines Beispielwerts zur Zelle "B3"
worksheet.Cells("B3").PutValue(50)
'Hinzufügen eines Beispielwerts zur Zelle "B4"
worksheet.Cells("B4").PutValue(40)
'Hinzufügen eines Beispielwerts zur Zelle "C1" als Kategoriedaten
worksheet.Cells("C1").PutValue("Q1")
'Hinzufügen eines Beispielwerts zur Zelle "C2" als Kategoriedaten
worksheet.Cells("C2").PutValue("Q2")
'Hinzufügen eines Beispielwerts zur Zelle "C3" als Kategoriedaten
worksheet.Cells("C3").PutValue("Y1")
'Hinzufügen eines Beispielwerts zur Zelle "C4" als Kategoriedaten
worksheet.Cells("C4").PutValue("Y2")
'Hinzufügen eines Diagramms zum Arbeitsblatt
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Zugriff auf die Instanz des neu hinzugefügten Diagramms
Dim chart As Chart = worksheet.Charts(chartIndex)
'Hinzufügen von NSeries (Diagramm-Datenquelle) zum Diagramm, das von der Zelle "A1" bis "B4" reicht
Dim seriesIndex As Int32 = chart.NSeries.Add("A1:B4", True)
'Festlegen der Datenquelle für die Kategoriedaten von NSeries
chart.NSeries.CategoryData = "C1:C4"
Dim series As Series = chart.NSeries(seriesIndex)
'Festlegen der Werte der Serie.
series.Values = "=B1:B4"
'Ändern des Diagrammtyps der Serie.
series.Type = ChartType.Line
'Festlegen der Marker-Eigenschaften.
series.Marker.MarkerStyle = ChartMarkerType.Circle
series.Marker.ForegroundColorSetType = FormattingType.Automatic
series.Marker.ForegroundColor = System.Drawing.Color.Black
series.Marker.BackgroundColorSetType = FormattingType.Automatic
'Speichern der Excel-Datei
workbook.Save("book1.xls")Eigenschaften
Area
Stellt den Hintergrundbereich des Series-Objekts dar.
public Area Area { get; }Eigenschaftswert
Bar3DShapeType
Erhält oder setzt den 3D-Formtyp, der mit dem 3D-Balken- oder Säulendiagramm verwendet wird.
public Bar3DShapeType Bar3DShapeType { get; set; }Eigenschaftswert
Border
Stellt den Rand des Series-Objekts dar.
public Line Border { get; }Eigenschaftswert
BubbleScale
Erhält oder setzt den Skalierungsfaktor für Blasen in der angegebenen Diagrammgruppe. Es kann ein ganzzahliger Wert von 0 (null) bis 300 sein, der einem Prozentsatz der Standardgröße entspricht. Gilt nur für Blasendiagramme.
public int BubbleScale { get; set; }Eigenschaftswert
BubbleSizes
Erhält oder setzt die Blasengrößenwerte der Diagrammreihe.
public string BubbleSizes { get; set; }Eigenschaftswert
CountOfDataValues
Erhält die Anzahl der Datenwerte.
public int CountOfDataValues { get; }Eigenschaftswert
DataLabels
Stellt das DataLabels-Objekt für die angegebene ASeries dar.
public DataLabels DataLabels { get; }Eigenschaftswert
DisplayName
Erhält den Namen der Serie, der im Diagramm angezeigt wird.
public string DisplayName { get; }Eigenschaftswert
DoughnutHoleSize
Gibt die Größe des Lochs in einer Donutdiagrammgruppe zurück oder setzt sie. Die Lochgröße wird als Prozentsatz der Diagrammgröße ausgedrückt, zwischen 10 und 90 Prozent.
public int DoughnutHoleSize { get; set; }Eigenschaftswert
DownBars
Gibt ein Aspose.Cells.Charts.DropBars-Objekt zurück, das die Abwärtsbalken in einem Liniendiagramm darstellt. Gilt nur für Liniendiagramme.
public DropBars DownBars { get; }Eigenschaftswert
DropLines
Gibt ein Aspose.Cells.Drawing.Line-Objekt zurück, das die Drop-Linien für eine Reihe im Liniendiagramm oder Flächendiagramm darstellt. Gilt nur für Liniendiagramme oder Flächendiagramme.
public Line DropLines { get; }Eigenschaftswert
Explosion
Der Abstand eines offenen Tortenschnitts vom Zentrum des Tortendiagramms wird als Prozentsatz des Tortendurchmessers ausgedrückt.
public int Explosion { get; set; }Eigenschaftswert
FirstSliceAngle
Erhält oder setzt den Winkel des ersten Torten- oder Donutschnitts in Grad (im Uhrzeigersinn von der Vertikalen). Gilt nur für Torten-, 3D-Torten- und Donutdiagramme, 0 bis 360.
public short FirstSliceAngle { get; set; }Eigenschaftswert
GapWidth
Gibt den Abstand zwischen Balken- oder Säulengruppen als Prozentsatz der Balken- oder Säulenbreite zurück oder setzt ihn. Der Wert dieser Eigenschaft muss zwischen 0 und 500 liegen.
public short GapWidth { get; set; }Eigenschaftswert
Has3DEffect
Wahr, wenn die Serie ein dreidimensionales Aussehen hat. Gilt nur für Blasendiagramme.
public bool Has3DEffect { get; set; }Eigenschaftswert
HasDropLines
Wahr, wenn das Diagramm Drop-Linien hat. Gilt nur für Liniendiagramme oder Flächendiagramme.
public bool HasDropLines { get; set; }Eigenschaftswert
HasHiLoLines
Wahr, wenn das Liniendiagramm Hoch-Tief-Linien hat. Gilt nur für Liniendiagramme.
public bool HasHiLoLines { get; set; }Eigenschaftswert
HasLeaderLines
Wahr, wenn die Serie Führungslinien hat.
public bool HasLeaderLines { get; set; }Eigenschaftswert
HasRadarAxisLabels
Wahr, wenn ein Radardiagramm Kategoriewerte hat. Gilt nur für Radardiagramme.
public bool HasRadarAxisLabels { get; set; }Eigenschaftswert
HasSeriesLines
Wahr, wenn ein gestapeltes Säulendiagramm oder Balkendiagramm Serienlinien hat oder wenn ein Torten- oder Balkendiagramm Verbindungsleitungen zwischen den beiden Abschnitten hat. Gilt nur für gestapelte Säulendiagramme, Balkendiagramme, Torten- oder Balkendiagramme.
public bool HasSeriesLines { get; set; }Eigenschaftswert
HasUpDownBars
Wahr, wenn ein Liniendiagramm Aufwärts- und Abwärtsbalken hat. Gilt nur für Liniendiagramme.
public bool HasUpDownBars { get; set; }Eigenschaftswert
HiLoLines
Gibt ein HiLoLines-Objekt zurück, das die Hoch-Tief-Linien für eine Reihe in einem Liniendiagramm darstellt. Gilt nur für Liniendiagramme.
public Line HiLoLines { get; }Eigenschaftswert
IsAutoSplit
Gibt an, ob der Schwellenwert automatisch ist.
public bool IsAutoSplit { get; }Eigenschaftswert
IsColorVaried
Stellt dar, ob die Farbe der Punkte variiert. Das Diagramm darf nur eine Serie enthalten.
public bool IsColorVaried { get; set; }Eigenschaftswert
IsFiltered
Gibt an, ob die Serie ausgewählt oder gefiltert ist. Wahr bedeutet, dass diese Serie gefiltert ist und nicht im Diagramm angezeigt wird.
public bool IsFiltered { get; set; }Eigenschaftswert
IsVerticalValues
Gibt an, ob die Datenquelle vertikal ist.
public bool IsVerticalValues { get; }Eigenschaftswert
LayoutProperties
Stellt die Eigenschaften des Layouts dar.
public SeriesLayoutProperties LayoutProperties { get; }Eigenschaftswert
LeaderLines
Stellt Führungsleitungen in einem Diagramm dar. Führungsleitungen verbinden Datenbeschriftungen mit Datenpunkten. Dieses Objekt ist keine Sammlung; es gibt kein Objekt, das eine einzelne Führungsleitung darstellt.
public Line LeaderLines { get; }Eigenschaftswert
LegendEntry
Erhält den Legenden-Eintrag gemäß dieser Serie.
public LegendEntry LegendEntry { get; }Eigenschaftswert
Marker
Erhält den Aspose.Cells.Charts.Series.Marker?text=marker.
public Marker Marker { get; }Eigenschaftswert
Name
Erhält oder setzt den Namen der Datenreihe.
public string Name { get; set; }Eigenschaftswert
Beispiele
//Referenzname zu einer Zelle
chart.NSeries[0].Name = "=A1";
//Setzen eines Strings als Namen
chart.NSeries[0].Name = "Erste Serie";'Referenzname zu einer Zelle
chart.NSeries[0].Name = "=A1"
'Setzen eines Strings als Namen
chart.NSeries[0].Name = "Erste Serie"Overlap
Gibt an, wie Balken und Säulen positioniert sind. Kann ein Wert zwischen -100 und 100 sein. Gilt nur für 2D-Balken- und 2D-Säulendiagramme.
public short Overlap { get; set; }Eigenschaftswert
PlotOnSecondAxis
Gibt an, ob diese Serie auf der zweiten Wertachse dargestellt wird.
public bool PlotOnSecondAxis { get; set; }Eigenschaftswert
Points
Erhält die Sammlung von Punkten in einer Serie in einem Diagramm.
public ChartPointCollection Points { get; }Eigenschaftswert
Anmerkungen
Wenn das Diagramm ein Torten- oder Balkendiagramm ist, ist der letzte Punkt ein anderer Punkt im ersten Tortendiagramm.
SecondPlotSize
Gibt die Größe des sekundären Abschnitts eines Torten- oder Balkendiagramms zurück oder setzt sie, als Prozentsatz der Größe der primären Torte. Kann einen Wert von 5 bis 200 haben.
public short SecondPlotSize { get; set; }Eigenschaftswert
SeriesLines
Gibt ein SeriesLines-Objekt zurück, das die Serienlinien für ein gestapeltes Balkendiagramm oder ein gestapeltes Säulendiagramm darstellt. Gilt nur für gestapelte Balken- und gestapelte Säulendiagramme.
public Line SeriesLines { get; }Eigenschaftswert
Shadow
Wahr, wenn die Serie einen Schatten hat.
public bool Shadow { get; set; }Eigenschaftswert
ShapeProperties
Erhält das Aspose.Cells.Drawing.ShapePropertyCollection-Objekt, das die visuellen Formeigenschaften der Serie enthält.
public ShapePropertyCollection ShapeProperties { get; }Eigenschaftswert
ShowNegativeBubbles
Wahr, wenn negative Blasen für die Diagrammgruppe angezeigt werden. Gültig nur für Blasendiagramme.
public bool ShowNegativeBubbles { get; set; }Eigenschaftswert
SizeRepresents
Erhält oder setzt, was die Blasengröße in einem Blasendiagramm darstellt.
public BubbleSizeRepresents SizeRepresents { get; set; }Eigenschaftswert
Anmerkungen
BubbleSizeRepresents.SizeIsArea bedeutet, dass der Wert von Aspose.Cells.Charts.Series.BubbleSizes die Fläche der Blase ist. BubbleSizeRepresents.SizeIsWidth bedeutet, dass der Wert von Aspose.Cells.Charts.Series.BubbleSizes die Breite der Blase ist.
Smooth
Stellt die Kurvenverfeinerung dar. Wahr, wenn die Kurvenverfeinerung für das Liniendiagramm oder Streudiagramm aktiviert ist. Gilt nur für Liniendiagramme und Streudiagramme, die durch Linien verbunden sind.
public bool Smooth { get; set; }Eigenschaftswert
SplitType
Gibt einen Wert zurück oder setzt diesen, wie bestimmt wird, welche Datenpunkte im zweiten Torten- oder Balkendiagramm eines Torten- oder Balkendiagramms sind.
public ChartSplitType SplitType { get; set; }Eigenschaftswert
SplitValue
Gibt einen Wert zurück oder setzt diesen, der verwendet wird, um zu bestimmen, welche Datenpunkte im zweiten Torten- oder Balkendiagramm eines Torten- oder Balkendiagramms sind.
public double SplitValue { get; set; }Eigenschaftswert
TrendLines
Gibt alle Trendlinien dieser Serie zurück.
public TrendlineCollection TrendLines { get; }Eigenschaftswert
Type
Erhält oder setzt den Typ einer Datenreihe.
public ChartType Type { get; set; }Eigenschaftswert
UpBars
Gibt ein DropBars-Objekt zurück, das die Aufwärtsbalken in einem Liniendiagramm darstellt. Gilt nur für Liniendiagramme.
public DropBars UpBars { get; }Eigenschaftswert
Values
Stellt die Y-Werte dieser Diagrammreihe dar.
public string Values { get; set; }Eigenschaftswert
ValuesFormatCode
Stellt den Formatcode der Values’s NumberList dar.
public string ValuesFormatCode { get; set; }Eigenschaftswert
XErrorBar
Stellt die Fehlerbalken in X-Richtung der Serie dar.
public ErrorBar XErrorBar { get; }Eigenschaftswert
XValues
Stellt die X-Werte der Diagrammreihe dar.
public string XValues { get; set; }Eigenschaftswert
XValuesFormatCode
Stellt den Formatcode der X Values’s NumberList dar.
public string XValuesFormatCode { get; set; }Eigenschaftswert
YErrorBar
Stellt die Fehlerbalken in Y-Richtung der Serie dar.
public ErrorBar YErrorBar { get; }Eigenschaftswert
Methoden
Move(int)
Bewegt die Serie nach oben oder unten.
public void Move(int count)Parameter
count int
Die Anzahl der Bewegungen nach oben oder unten. Bewege die Serie nach oben, wenn dies kleiner als null ist; Bewege die Serie nach unten, wenn dies größer als null ist.
