Series

Series class

Kapselt das Objekt, das eine einzelne Datenreihe in einem Diagramm darstellt.

public class Series

Eigenschaften

NameBeschreibung
Area { get; }Repräsentiert den Hintergrundbereich des Serienobjekts.
Bar3DShapeType { get; set; }Ruft den 3D-Formtyp ab oder legt ihn fest, der mit dem 3D-Balken- oder Säulendiagramm verwendet wird.
Border { get; }Repräsentiert den Rand des Serienobjekts.
BubbleScale { get; set; }Ruft den Skalierungsfaktor für Blasen in der angegebenen Diagrammgruppe ab oder legt ihn fest. Dies kann ein ganzzahliger Wert von 0 (null) bis 300 sein, entspricht einem Prozentsatz der Standardgröße. Gilt nur für Blasendiagramme.
BubbleSizes { get; set; }Ruft die Blasengrößenwerte der Diagrammreihe ab oder legt sie fest.
CountOfDataValues { get; }Ruft die Anzahl der Datenwerte ab.
DataLabels { get; }Repräsentiert das DataLabels-Objekt für die angegebene ASeries.
DisplayName { get; }Ruft den Namen der Reihe ab, der im Diagramm angezeigt wird.
DoughnutHoleSize { get; set; }Gibt die Größe des Lochs in einer Ringdiagrammgruppe zurück oder legt sie fest. Die Lochgröße wird als Prozentsatz der Diagrammgröße ausgedrückt, zwischen 10 und 90 Prozent.
DownBars { get; }Gibt a zurückDropBars Objekt, das die Abwärtsbalken in einem Liniendiagramm darstellt. Gilt nur für Liniendiagramme.
DropLines { get; }Gibt a zurückLine Objekt, das die Falllinien für eine Reihe im Linien- oder Flächendiagramm darstellt. Gilt nur für Linien- oder Flächendiagramme.
Explosion { get; set; }Der Abstand eines offenen Tortenstücks von der Mitte des Tortendiagramms wird als Prozentsatz des Tortendurchmessers ausgedrückt.
FirstSliceAngle { get; set; }Liest oder setzt den Winkel des ersten Torten- oder Doughnut-Diagramms in Grad (im Uhrzeigersinn von der Vertikalen). Gilt nur für Kreis-, 3D-Kreis- und Ringdiagramme, 0 bis 360.
GapWidth { get; set; }Gibt den Abstand zwischen Balken- oder Spaltenclustern als Prozentsatz der Balken- oder Spaltenbreite zurück oder legt ihn fest. Der Wert dieser Eigenschaft muss zwischen 0 und 500 liegen.
Has3DEffect { get; set; }True, wenn die Reihe dreidimensional aussieht. Gilt nur für Blasendiagramme.
HasDropLines { get; set; }Wahr, wenn das Diagramm Falllinien hat. Gilt nur für Liniendiagramme oder Flächendiagramme.
HasHiLoLines { get; set; }Wahr, wenn das Liniendiagramm Hoch-Tief-Linien hat. Gilt nur für Liniendiagramme.
HasLeaderLines { get; set; }Wahr, wenn die Serie Führungslinien hat.
HasRadarAxisLabels { get; set; }Wahr, wenn ein Netzdiagramm Kategorienachsenbeschriftungen hat. Gilt nur für Radarkarten.
HasSeriesLines { get; set; }Wahr, wenn ein gestapeltes Säulen- oder Balkendiagramm Reihenlinien aufweist, oder , wenn ein Tortendiagramm oder ein Balkendiagramm Verbindungslinien zwischen den beiden Abschnitten aufweist. Gilt nur für gestapelte Säulendiagramme, Balkendiagramme, Tortendiagramme oder Balkendiagramme.
HasUpDownBars { get; set; }Wahr, wenn ein Liniendiagramm Aufwärts- und Abwärtsbalken hat. Gilt nur für Liniendiagramme.
HiLoLines { get; }Gibt ein HiLoLines-Objekt zurück, das die High-Low-Linien für eine Reihe in einem Liniendiagramm darstellt. Gilt nur für Liniendiagramme.
IsAutoSplit { get; }Gibt an, ob der Schwellenwert automatisch ist.
IsColorVaried { get; set; }Stellt dar, ob die Farbe der Punkte variiert wird. Das Diagramm darf nur eine Reihe enthalten.
IsVerticalValues { get; }Gibt an, ob die Datenquelle vertikal ist.
LayoutProperties { get; }Repräsentiert die Eigenschaften des Layouts.
LeaderLines { get; }Repräsentiert Führungslinien auf einem Diagramm. Führungslinien verbinden Datenbeschriftungen mit Datenpunkten. Dieses Objekt ist keine Sammlung; Es gibt kein Objekt, das eine einzelne Führungslinie darstellt.
LegendEntry { get; }Ruft den Legendeneintrag gemäß dieser Reihe ab.
Marker { get; }Ruft die abMarker .
Name { get; set; }Holt oder setzt den Namen der Datenreihe.
Overlap { get; set; }Gibt an, wie Balken und Säulen positioniert werden. Kann ein Wert zwischen – 100 und 100 sein. Gilt nur für 2-D-Balken- und 2-D-Säulendiagramme.
PlotOnSecondAxis { get; set; }Gibt an, ob diese Reihe auf der zweiten Werteachse aufgetragen wird.
Points { get; }Ruft die Sammlung von Punkten in einer Reihe in einem Diagramm ab.
SecondPlotSize { get; set; }Gibt die Größe des sekundären Abschnitts entweder eines Tortendiagramms oder eines Balkendiagramms zurück oder legt sie fest, als Prozentsatz der Größe des primären Tortendiagramms. Kann ein Wert zwischen 5 und 200 sein.
SeriesLines { get; }Gibt ein SeriesLines-Objekt zurück, das die Reihenlinien für ein gestapeltes Balkendiagramm oder ein gestapeltes Säulendiagramm darstellt. Gilt nur für gestapelte Balken- und gestapelte Säulendiagramme.
Shadow { get; set; }True, wenn die Serie einen Schatten hat.
ShapeProperties { get; }Ruft die ab Objekt, das die visuellen Formeigenschaften der Serie enthält.
ShowNegativeBubbles { get; set; }Wahr, wenn negative Blasen für die Diagrammgruppe angezeigt werden. Gilt nur für Blasendiagramme.
SizeRepresents { get; set; }Ruft ab oder legt fest, was die Blasengröße in einem Blasendiagramm darstellt.
Smooth { get; set; }Repräsentiert die Kurvenglättung. Wahr, wenn die Kurvenglättung für das Linien- oder Streudiagramm aktiviert ist. Gilt nur für Linien- und Streudiagramme, die durch Linien verbunden sind.
SplitType { get; set; }Gibt einen Wert zurück oder legt einen Wert fest, mit dem bestimmt wird, welche Datenpunkte sich im zweiten Kreis oder Balken auf einem Torten- oder Balkendiagramm von befinden.
SplitValue { get; set; }Gibt einen Wert zurück oder legt einen Wert fest, der verwendet werden soll, um zu bestimmen, welche Datenpunkte sich im zweiten Kreis oder Balken auf einem Torten- oder Balkendiagramm befinden.
TrendLines { get; }Gibt ein Objekt zurück, das eine Sammlung aller Trendlinien für die Reihe darstellt.
Type { get; set; }Ruft den Typ einer Datenreihe ab oder legt ihn fest.
UpBars { get; }Gibt ein DropBars-Objekt zurück, das die Aufwärtsbalken in einem Liniendiagramm darstellt. Gilt nur für Liniendiagramme.
Values { get; set; }Repräsentiert die Daten der Diagrammreihe.
ValuesFormatCode { get; set; }Repräsentiert den Formatcode der NumberList von Values.
XErrorBar { get; }Stellt den X-Richtungsfehlerbalken der Serie dar.
XValues { get; set; }Stellt die x-Werte der Diagrammreihe dar.
YErrorBar { get; }Repräsentiert den Y-Richtungsfehlerbalken der Serie.

Methoden

NameBeschreibung
Move(int)Verschiebt die Reihe nach oben oder unten.

Beispiele


[C#]

//Instanziieren eines Workbook-Objekts
Workbook workbook = new Workbook();
//Hinzufügen eines neuen Arbeitsblatts zum Excel-Objekt
int sheetIndex = workbook.Worksheets.Add();
//Beziehen 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);
//Auf die Instanz des neu hinzugefügten Diagramms zugreifen
Chart chart = worksheet.Charts[chartIndex];
//Hinzufügen von NSeries (Diagrammdatenquelle) zum Diagramm im Bereich von Zelle "A1" bis "B4"
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 Reihe.
series.Values = "=B1:B4";
//Ändern des Diagrammtyps der Serie.
series.Type = ChartType.Line;
//Markereigenschaften setzen.
series.Marker.MarkerStyle = ChartMarkerType.Circle;
series.Marker.ForegroundColorSetType = FormattingType.Automatic;
series.Marker.ForegroundColor = System.Drawing.Color.Black;
series.Marker.BackgroundColorSetType = FormattingType.Automatic;

// Mach dein Geschäft

//Speichern der Excel-Datei
workbook.Save("book1.xls");

[Visual Basic]

'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()
'Abrufen der Referenz des neu hinzugefügten Arbeitsblatts durch Übergeben seines Blattindex
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")
'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)
'Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B4"
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)
'Einstellen der Werte der Reihe.
series.Values = "=B1:B4"
'Ändern des Diagrammtyps der Reihe.
series.Type = ChartType.Line
'Markierungseigenschaften festlegen.
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")

Siehe auch

QuartileCalculationType SeriesCollection