Class SeriesCollection
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Encapsule une collection d’objets Aspose.Cells.Charts.Series.
public class SeriesCollection : CollectionBase<series>, IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerableHéritage
object ← CollectionBase<series> ← SeriesCollection
Implémente
IList<series>, ICollection<series>, IEnumerable<series>, ICollection, IEnumerable
Membres hérités
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()
Exemples
//Instanciation d'un objet Workbook
Workbook workbook = new Workbook();
//Ajout d'une nouvelle feuille de calcul à l'objet Excel
int sheetIndex = workbook.Worksheets.Add();
//Obtention de la référence de la nouvelle feuille de calcul en passant son index
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Ajout d'une valeur d'exemple à la cellule "A1"
worksheet.Cells["A1"].PutValue(50);
//Ajout d'une valeur d'exemple à la cellule "A2"
worksheet.Cells["A2"].PutValue(100);
//Ajout d'une valeur d'exemple à la cellule "A3"
worksheet.Cells["A3"].PutValue(150);
//Ajout d'une valeur d'exemple à la cellule "A4"
worksheet.Cells["A4"].PutValue(200);
//Ajout d'une valeur d'exemple à la cellule "B1"
worksheet.Cells["B1"].PutValue(60);
//Ajout d'une valeur d'exemple à la cellule "B2"
worksheet.Cells["B2"].PutValue(32);
//Ajout d'une valeur d'exemple à la cellule "B3"
worksheet.Cells["B3"].PutValue(50);
//Ajout d'une valeur d'exemple à la cellule "B4"
worksheet.Cells["B4"].PutValue(40);
//Ajout d'une valeur d'exemple à la cellule "C1" comme données de catégorie
worksheet.Cells["C1"].PutValue("T1");
//Ajout d'une valeur d'exemple à la cellule "C2" comme données de catégorie
worksheet.Cells["C2"].PutValue("T2");
//Ajout d'une valeur d'exemple à la cellule "C3" comme données de catégorie
worksheet.Cells["C3"].PutValue("Y1");
//Ajout d'une valeur d'exemple à la cellule "C4" comme données de catégorie
worksheet.Cells["C4"].PutValue("Y2");
//Ajout d'un graphique à la feuille de calcul
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//Accès à l'instance du graphique nouvellement ajouté
Chart chart = worksheet.Charts[chartIndex];
//Ajout de NSeries (source de données du graphique) au graphique allant de la cellule "A1" à "B4"
chart.NSeries.Add("A1:B4", true);
//Définition de la source de données pour les données de catégorie de NSeries
chart.NSeries.CategoryData = "C1:C4";
//Sauvegarde du fichier Excel
workbook.Save("book1.xls");'Instanciation d'un objet Workbook
Dim workbook As Workbook = New Workbook()
'Ajout d'une nouvelle feuille de calcul à l'objet Excel
Dim sheetIndex As Integer = workbook.Worksheets.Add()
'Obtention de la référence de la nouvelle feuille de calcul en passant son index
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Ajout d'une valeur d'exemple à la cellule "A1"
worksheet.Cells("A1").PutValue(50)
'Ajout d'une valeur d'exemple à la cellule "A2"
worksheet.Cells("A2").PutValue(100)
'Ajout d'une valeur d'exemple à la cellule "A3"
worksheet.Cells("A3").PutValue(150)
'Ajout d'une valeur d'exemple à la cellule "A4"
worksheet.Cells("A4").PutValue(200)
'Ajout d'une valeur d'exemple à la cellule "B1"
worksheet.Cells("B1").PutValue(60)
'Ajout d'une valeur d'exemple à la cellule "B2"
worksheet.Cells("B2").PutValue(32)
'Ajout d'une valeur d'exemple à la cellule "B3"
worksheet.Cells("B3").PutValue(50)
'Ajout d'une valeur d'exemple à la cellule "B4"
worksheet.Cells("B4").PutValue(40)
'Ajout d'une valeur d'exemple à la cellule "C1" comme données de catégorie
worksheet.Cells("C1").PutValue("T1")
'Ajout d'une valeur d'exemple à la cellule "C2" comme données de catégorie
worksheet.Cells("C2").PutValue("T2")
'Ajout d'une valeur d'exemple à la cellule "C3" comme données de catégorie
worksheet.Cells("C3").PutValue("Y1")
'Ajout d'une valeur d'exemple à la cellule "C4" comme données de catégorie
worksheet.Cells("C4").PutValue("Y2")
'Ajout d'un graphique à la feuille de calcul
Dim chartIndex As Integer = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Accès à l'instance du graphique nouvellement ajouté
Dim chart As Chart = worksheet.Charts(chartIndex)
'Ajout de NSeries (source de données du graphique) au graphique allant de la cellule "A1" à "B4"
chart.NSeries.Add("A1:B4", True)
'Définition de la source de données pour les données de catégorie de NSeries
chart.NSeries.CategoryData = "C1:C4"
'Sauvegarde du fichier Excel
workbook.Save("book1.xls")Propriétés
CategoryData
Obtient ou définit la plage des valeurs de l’axe des catégories. Cela peut être une plage de cellules (par exemple, “d1:e10”), ou une séquence de valeurs (par exemple, “{2,6,8,10}”).
public string CategoryData { get; set; }Valeur de la propriété
IsColorVaried
Représente si la couleur des points est variée.
public bool IsColorVaried { get; set; }Valeur de la propriété
SecondCategoryData
Obtient ou définit la plage des valeurs de l’axe de seconde catégorie. Cela peut être une plage de cellules (par exemple, “d1:e10”), ou une séquence de valeurs (par exemple, “{2,6,8,10}”). N’affecte que lorsque certaines ASeries sont tracées sur le deuxième axe.
public string SecondCategoryData { get; set; }Valeur de la propriété
this[int]
Obtient l’élément Aspose.Cells.Charts.Series à l’index spécifié.
public Series this[int index] { get; }Valeur de la propriété
Méthodes
Add(string, bool)
Ajoute la collection Aspose.Cells.Charts.Series à un graphique.
public int Add(string area, bool isVertical)Paramètres
area string
Spécifie les valeurs à partir desquelles tracer la série de données
isVertical bool
Spécifie si la série doit être tracée à partir d’une plage de valeurs de cellules par ligne ou par colonne.
Renvoie
Renvoie le premier index de la ASeries ajoutée dans la NSeries.
Remarques
Si les données sont définies sur des cellules contiguës, utilisez deux-points pour les séparer. Par exemple, $C$2:$C$5.
Si les données sont définies sur des cellules non contiguës, utilisez une virgule pour les séparer. Par exemple : ($C$2,$D$5).
Add(string, bool, bool)
Ajoute la collection Aspose.Cells.Charts.Series à un graphique.
public int Add(string area, bool isVertical, bool checkLabels)Paramètres
area string
Spécifie les valeurs à partir desquelles tracer la série de données
isVertical bool
Spécifie si la série doit être tracée à partir d’une plage de valeurs de cellules par ligne ou par colonne.
checkLabels bool
Indique si la plage contient le nom des séries
Renvoie
Renvoie le premier index de la ASeries ajoutée dans la NSeries.
Remarques
Si les données sont définies sur des cellules contiguës, utilisez deux-points pour les séparer. Par exemple, $C$2:$C$5.
Si les données sont définies sur des cellules non contiguës, utilisez une virgule pour les séparer. Par exemple : ($C$2,$D$5).
AddR1C1(string, bool)
Ajoute la collection Aspose.Cells.Charts.Series à un graphique.
public int AddR1C1(string area, bool isVertical)Paramètres
area string
Spécifie les valeurs à partir desquelles tracer la série de données
isVertical bool
Spécifie si la série doit être tracée à partir d’une plage de valeurs de cellules par ligne ou par colonne.
Renvoie
Renvoie le premier index de la ASeries ajoutée dans la NSeries.
Remarques
Si les données sont définies sur des cellules contiguës, utilisez deux-points pour les séparer. Par exemple, R[1]C[1]:R[3]C[2].
Si les données sont définies sur des cellules non contiguës, utilisez une virgule pour les séparer. Par exemple : (R[1]C[1],R[3]C[2]).
Clear()
Efface la collection
public void Clear()GetSeriesByOrder(int)
Obtient l’élément Aspose.Cells.Charts.Series par ordre.
public Series GetSeriesByOrder(int order)Paramètres
order int
L’ordre des séries
Renvoie
L’élément série
RemoveAt(int)
Supprime une série à l’index spécifique.
public void RemoveAt(int index)Paramètres
index int
L’index.
SetSeriesNames(int, string, bool)
Définit le nom de toutes les séries dans le graphique.
public void SetSeriesNames(int startIndex, string area, bool isVertical)Paramètres
startIndex int
L’index de la première série pour laquelle vous souhaitez définir le nom.
area string
Spécifie la zone pour le nom de la série.
isVertical bool
Spécifie si la série doit être tracée à partir d’une plage de valeurs de cellules par ligne ou par colonne.
Remarques
Si l’index de départ est supérieur au nombre de séries, il renverra et ne fera rien.
Si les données sont définies sur des cellules contiguës, utilisez deux-points pour les séparer. Par exemple, $C$2:$C$5.
Si les données sont définies sur des cellules non contiguës, utilisez une virgule pour les séparer. Par exemple : ($C$2,$D$5).
SwapSeries(int, int)
Change directement les ordres des deux séries.
public void SwapSeries(int sourceIndex, int destIndex)Paramètres
sourceIndex int
L’index actuel
destIndex int
L’index de destination
