Class SeriesCollection
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Kapselt eine Sammlung von Aspose.Cells.Charts.Series-Objekten.
public class SeriesCollection : CollectionBase<series>, IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerableVererbung
object ← CollectionBase<series> ← SeriesCollection
Implementiert
IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerable
Vererbte Mitglieder
CollectionBase<series>.BinarySearch(Series), CollectionBase<series>.BinarySearch(Series, IComparer<series>), CollectionBase<series>.BinarySearch(int, int, Series, IComparer<series>), CollectionBase<series>.Contains(Series), CollectionBase<series>.CopyTo(Series[]), CollectionBase<series>.CopyTo(Series[], int), CollectionBase<series>.CopyTo(int, Series[], int, int), CollectionBase<series>.Exists(Predicate<series>), CollectionBase<series>.Find(Predicate<series>), CollectionBase<series>.FindAll(Predicate<series>), CollectionBase<series>.FindIndex(Predicate<series>), CollectionBase<series>.FindIndex(int, Predicate<series>), CollectionBase<series>.FindIndex(int, int, Predicate<series>), CollectionBase<series>.FindLast(Predicate<series>), CollectionBase<series>.FindLastIndex(Predicate<series>), CollectionBase<series>.FindLastIndex(int, Predicate<series>), CollectionBase<series>.FindLastIndex(int, int, Predicate<series>), CollectionBase<series>.IndexOf(Series), CollectionBase<series>.IndexOf(Series, int), CollectionBase<series>.IndexOf(Series, int, int), CollectionBase<series>.LastIndexOf(Series), CollectionBase<series>.LastIndexOf(Series, int), CollectionBase<series>.LastIndexOf(Series, int, int), CollectionBase<series>.GetEnumerator(), CollectionBase<series>.Clear(), CollectionBase<series>.RemoveAt(int), CollectionBase<series>.OnClearComplete(), CollectionBase<series>.OnClear(), CollectionBase<series>.Capacity, CollectionBase<series>.Count, CollectionBase<series>.InnerList, CollectionBase<series>.this[int], object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Beispiele
//Instanziierung 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 Übergabe seines Arbeitsblattindex
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 (Diagrammdatenquelle) zum Diagramm von der Zelle "A1" bis "B4"
chart.NSeries.Add("A1:B4", true);
//Festlegen der Datenquelle für die Kategoriedaten von NSeries
chart.NSeries.CategoryData = "C1:C4";
//Speichern der Excel-Datei
workbook.Save("book1.xls");'Instanziierung eines Workbook-Objekts
Dim workbook As Workbook = New Workbook()
'Hinzufügen eines neuen Arbeitsblatts zum Excel-Objekt
Dim sheetIndex As Integer = workbook.Worksheets.Add()
'Erhalten der Referenz des neu hinzugefügten Arbeitsblatts durch Übergabe seines Arbeitsblattindex
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 Integer = 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 (Diagrammdatenquelle) zum Diagramm von der Zelle "A1" bis "B4"
chart.NSeries.Add("A1:B4", True)
'Festlegen der Datenquelle für die Kategoriedaten von NSeries
chart.NSeries.CategoryData = "C1:C4"
'Speichern der Excel-Datei
workbook.Save("book1.xls")Eigenschaften
CategoryData
Erhält oder setzt den Bereich der Werte der Kategoriewerte. Es kann ein Bereich von Zellen (z. B. “d1:e10”), oder eine Sequenz von Werten (z. B. “{2,6,8,10}”) sein.
public string CategoryData { get; set; }Eigenschaftswert
IsColorVaried
Stellt dar, ob die Farbe der Punkte variiert.
public bool IsColorVaried { get; set; }Eigenschaftswert
SecondCategoryData
Erhält oder setzt den Bereich der Werte der zweiten Kategorie. Es kann ein Bereich von Zellen (z. B. “d1:e10”), oder eine Sequenz von Werten (z. B. “{2,6,8,10}”) sein. Hat nur Auswirkungen, wenn einige ASerieses auf der zweiten Achse gezeichnet werden.
public string SecondCategoryData { get; set; }Eigenschaftswert
this[int]
Erhält das Aspose.Cells.Charts.Series-Element am angegebenen Index.
public Series this[int index] { get; }Eigenschaftswert
Methoden
Add(string, bool)
Fügt die Aspose.Cells.Charts.Series-Sammlung zu einem Diagramm hinzu.
public int Add(string area, bool isVertical)Parameter
area string
Gibt die Werte an, von denen die Datenreihe gezeichnet werden soll
isVertical bool
Gibt an, ob die Serie aus einem Bereich von Zellwerten zeilenweise oder spaltenweise gezeichnet werden soll.
Rückgabe
Gibt den ersten Index der hinzugefügten ASeries in der NSeries zurück.
Bemerkungen
Wenn Daten in zusammenhängenden Zellen festgelegt werden, verwenden Sie einen Doppelpunkt, um sie zu trennen. Zum Beispiel: $C$2:$C$5.
Wenn Daten in nicht zusammenhängenden Zellen festgelegt werden, verwenden Sie ein Komma, um sie zu trennen. Zum Beispiel: ($C$2,$D$5).
Add(string, bool, bool)
Fügt die Aspose.Cells.Charts.Series-Sammlung zu einem Diagramm hinzu.
public int Add(string area, bool isVertical, bool checkLabels)Parameter
area string
Gibt die Werte an, von denen die Datenreihe gezeichnet werden soll
isVertical bool
Gibt an, ob die Serie aus einem Bereich von Zellwerten zeilenweise oder spaltenweise gezeichnet werden soll.
checkLabels bool
Gibt an, ob der Bereich die Namen der Serien enthält.
Rückgabe
Gibt den ersten Index der hinzugefügten ASeries in der NSeries zurück.
Bemerkungen
Wenn Daten in zusammenhängenden Zellen festgelegt werden, verwenden Sie einen Doppelpunkt, um sie zu trennen. Zum Beispiel: $C$2:$C$5.
Wenn Daten in nicht zusammenhängenden Zellen festgelegt werden, verwenden Sie ein Komma, um sie zu trennen. Zum Beispiel: ($C$2,$D$5).
AddR1C1(string, bool)
Fügt die Aspose.Cells.Charts.Series-Sammlung zu einem Diagramm hinzu.
public int AddR1C1(string area, bool isVertical)Parameter
area string
Gibt die Werte an, von denen die Datenreihe gezeichnet werden soll
isVertical bool
Gibt an, ob die Serie aus einem Bereich von Zellwerten zeilenweise oder spaltenweise gezeichnet werden soll.
Rückgabe
Gibt den ersten Index der hinzugefügten ASeries in der NSeries zurück.
Bemerkungen
Wenn Daten in zusammenhängenden Zellen festgelegt werden, verwenden Sie einen Doppelpunkt, um sie zu trennen. Zum Beispiel: R[1]C[1]:R[3]C[2].
Wenn Daten in nicht zusammenhängenden Zellen festgelegt werden, verwenden Sie ein Komma, um sie zu trennen. Zum Beispiel: (R[1]C[1],R[3]C[2]).
Clear()
Löscht die Sammlung
public void Clear()GetSeriesByOrder(int)
Erhält das Aspose.Cells.Charts.Series-Element nach Reihenfolge.
public Series GetSeriesByOrder(int order)Parameter
order int
Die Reihenfolge der Serie
Rückgabe
Das Element der Serie
RemoveAt(int)
Entfernt eine Serie an dem spezifischen Index.
public void RemoveAt(int index)Parameter
index int
Der Index.
SetSeriesNames(int, string, bool)
Setzt den Namen aller Serien im Diagramm.
public void SetSeriesNames(int startIndex, string area, bool isVertical)Parameter
startIndex int
Der Index der ersten Serie, für die Sie den Namen festlegen möchten.
area string
Gibt den Bereich für den Seriennamen an.
isVertical bool
Gibt an, ob die Serie aus einem Bereich von Zellwerten zeilenweise oder spaltenweise gezeichnet werden soll.
Bemerkungen
Wenn der Startindex größer ist als die Anzahl der Serien, wird nichts zurückgegeben und es wird nichts unternommen.
Wenn Daten in zusammenhängenden Zellen festgelegt werden, verwenden Sie einen Doppelpunkt, um sie zu trennen. Zum Beispiel: $C$2:$C$5.
Wenn Daten in nicht zusammenhängenden Zellen festgelegt werden, verwenden Sie ein Komma, um sie zu trennen. Zum Beispiel: ($C$2,$D$5).
SwapSeries(int, int)
Ändert direkt die Reihenfolge der beiden Serien.
public void SwapSeries(int sourceIndex, int destIndex)Parameter
sourceIndex int
Der aktuelle Index
destIndex int
Der Zielindex
