Class Series
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Encapsule l’objet qui représente une seule série de données dans un graphique.
public class SeriesHéritage
Membres hérités
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Exemples
//Instancier un objet Workbook
Workbook workbook = new Workbook();
//Ajouter une nouvelle feuille de calcul à l'objet Excel
int sheetIndex = workbook.Worksheets.Add();
//Obtenir la référence de la feuille de calcul nouvellement ajoutée en passant son index de feuille
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Ajouter une valeur d'exemple à la cellule "A1"
worksheet.Cells["A1"].PutValue(50);
//Ajouter une valeur d'exemple à la cellule "A2"
worksheet.Cells["A2"].PutValue(100);
//Ajouter une valeur d'exemple à la cellule "A3"
worksheet.Cells["A3"].PutValue(150);
//Ajouter une valeur d'exemple à la cellule "A4"
worksheet.Cells["A4"].PutValue(200);
//Ajouter une valeur d'exemple à la cellule "B1"
worksheet.Cells["B1"].PutValue(60);
//Ajouter une valeur d'exemple à la cellule "B2"
worksheet.Cells["B2"].PutValue(32);
//Ajouter une valeur d'exemple à la cellule "B3"
worksheet.Cells["B3"].PutValue(50);
//Ajouter une valeur d'exemple à la cellule "B4"
worksheet.Cells["B4"].PutValue(40);
//Ajouter une valeur d'exemple à la cellule "C1" en tant que données de catégorie
worksheet.Cells["C1"].PutValue("T1");
//Ajouter une valeur d'exemple à la cellule "C2" en tant que données de catégorie
worksheet.Cells["C2"].PutValue("T2");
//Ajouter une valeur d'exemple à la cellule "C3" en tant que données de catégorie
worksheet.Cells["C3"].PutValue("Y1");
//Ajouter une valeur d'exemple à la cellule "C4" en tant que données de catégorie
worksheet.Cells["C4"].PutValue("Y2");
//Ajouter un graphique à la feuille de calcul
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//Accéder à l'instance du graphique nouvellement ajouté
Chart chart = worksheet.Charts[chartIndex];
//Ajouter NSeries (source de données du graphique) au graphique allant de la cellule "A1" à "B4"
int seriesIndex = chart.NSeries.Add("A1:B4", true);
//Définir la source de données pour les données de catégorie de NSeries
chart.NSeries.CategoryData = "C1:C4";
Series series = chart.NSeries[seriesIndex];
//Définir les valeurs de la série.
series.Values = "=B1:B4";
//Changer le type de graphique de la série.
series.Type = ChartType.Line;
//Définir les propriétés du marqueur.
series.Marker.MarkerStyle = ChartMarkerType.Circle;
series.Marker.ForegroundColorSetType = FormattingType.Automatic;
series.Marker.ForegroundColor = System.Drawing.Color.Black;
series.Marker.BackgroundColorSetType = FormattingType.Automatic;
//faites votre travail
//Sauvegarder le fichier Excel
workbook.Save("book1.xls");'Instancier un objet Workbook
Dim workbook As Workbook = New Workbook()
'Ajouter une nouvelle feuille de calcul à l'objet Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Obtenir la référence de la feuille de calcul nouvellement ajoutée en passant son index de feuille
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Ajouter une valeur d'exemple à la cellule "A1"
worksheet.Cells("A1").PutValue(50)
'Ajouter une valeur d'exemple à la cellule "A2"
worksheet.Cells("A2").PutValue(100)
'Ajouter une valeur d'exemple à la cellule "A3"
worksheet.Cells("A3").PutValue(150)
'Ajouter une valeur d'exemple à la cellule "A4"
worksheet.Cells("A4").PutValue(200)
'Ajouter une valeur d'exemple à la cellule "B1"
worksheet.Cells("B1").PutValue(60)
'Ajouter une valeur d'exemple à la cellule "B2"
worksheet.Cells("B2").PutValue(32)
'Ajouter une valeur d'exemple à la cellule "B3"
worksheet.Cells("B3").PutValue(50)
'Ajouter une valeur d'exemple à la cellule "B4"
worksheet.Cells("B4").PutValue(40)
'Ajouter une valeur d'exemple à la cellule "C1" en tant que données de catégorie
worksheet.Cells("C1").PutValue("T1")
'Ajouter une valeur d'exemple à la cellule "C2" en tant que données de catégorie
worksheet.Cells("C2").PutValue("T2")
'Ajouter une valeur d'exemple à la cellule "C3" en tant que données de catégorie
worksheet.Cells("C3").PutValue("Y1")
'Ajouter une valeur d'exemple à la cellule "C4" en tant que données de catégorie
worksheet.Cells("C4").PutValue("Y2")
'Ajouter un graphique à la feuille de calcul
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Accéder à l'instance du graphique nouvellement ajouté
Dim chart As Chart = worksheet.Charts(chartIndex)
'Ajouter NSeries (source de données du graphique) au graphique allant de la cellule "A1" à "B4"
Dim seriesIndex As Int32 = chart.NSeries.Add("A1:B4", True)
'Définir la source de données pour les données de catégorie de NSeries
chart.NSeries.CategoryData = "C1:C4"
Dim series As Series = chart.NSeries(seriesIndex)
'Définir les valeurs de la série.
series.Values = "=B1:B4"
'Changer le type de graphique de la série.
series.Type = ChartType.Line
'Définir les propriétés du marqueur.
series.Marker.MarkerStyle = ChartMarkerType.Circle
series.Marker.ForegroundColorSetType = FormattingType.Automatic
series.Marker.ForegroundColor = System.Drawing.Color.Black
series.Marker.BackgroundColorSetType = FormattingType.Automatic
'Sauvegarder le fichier Excel
workbook.Save("book1.xls")Propriétés
Area
Représente la zone de fond de l’objet Series.
public Area Area { get; }Valeur de propriété
Bar3DShapeType
Obtient ou définit le type de forme 3D utilisé avec le graphique à barres ou à colonnes 3-D.
public Bar3DShapeType Bar3DShapeType { get; set; }Valeur de propriété
Border
Représente la bordure de l’objet Series.
public Line Border { get; }Valeur de propriété
BubbleScale
Obtient ou définit le facteur d’échelle pour les bulles dans le groupe de graphiques spécifié. Il peut s’agir d’une valeur entière de 0 (zéro) à 300, correspondant à un pourcentage de la taille par défaut. S’applique uniquement aux graphiques à bulles.
public int BubbleScale { get; set; }Valeur de propriété
BubbleSizes
Obtient ou définit les valeurs de tailles de bulles de la série de graphiques.
public string BubbleSizes { get; set; }Valeur de propriété
CountOfDataValues
Obtient le nombre de valeurs de données.
public int CountOfDataValues { get; }Valeur de propriété
DataLabels
Représente l’objet DataLabels pour le ASeries spécifié.
public DataLabels DataLabels { get; }Valeur de propriété
DisplayName
Obtient le nom de la série qui s’affiche sur le graphique.
public string DisplayName { get; }Valeur de propriété
DoughnutHoleSize
Renvoie ou définit la taille du trou dans un groupe de graphiques en anneau. La taille du trou est exprimée en pourcentage de la taille du graphique, entre 10 et 90 pour cent.
public int DoughnutHoleSize { get; set; }Valeur de propriété
DownBars
Renvoie un objet Aspose.Cells.Charts.DropBars qui représente les barres descendantes sur un graphique linéaire. S’applique uniquement aux graphiques linéaires.
public DropBars DownBars { get; }Valeur de propriété
DropLines
Renvoie un objet Aspose.Cells.Drawing.Line qui représente les lignes de chute pour une série sur le graphique linéaire ou le graphique de surface. S’applique uniquement aux graphiques linéaires ou de surface.
public Line DropLines { get; }Valeur de propriété
Explosion
La distance d’une tranche de tarte ouverte par rapport au centre du graphique circulaire est exprimée en pourcentage du diamètre de la tarte.
public int Explosion { get; set; }Valeur de propriété
FirstSliceAngle
Obtient ou définit l’angle de la première tranche de graphique circulaire ou de graphique en anneau, en degrés (dans le sens des aiguilles d’une montre à partir de la verticale). S’applique uniquement aux graphiques circulaires, graphiques circulaires 3-D et graphiques en anneau, de 0 à 360.
public short FirstSliceAngle { get; set; }Valeur de propriété
GapWidth
Renvoie ou définit l’espace entre les groupes de barres ou de colonnes, en pourcentage de la largeur des barres ou des colonnes. La valeur de cette propriété doit être comprise entre 0 et 500.
public short GapWidth { get; set; }Valeur de propriété
Has3DEffect
Vrai si la série a une apparence tridimensionnelle. S’applique uniquement aux graphiques à bulles.
public bool Has3DEffect { get; set; }Valeur de propriété
HasDropLines
Vrai si le graphique a des lignes de chute. S’applique uniquement aux graphiques linéaires ou de surface.
public bool HasDropLines { get; set; }Valeur de propriété
HasHiLoLines
Vrai si le graphique linéaire a des lignes hautes-basses. S’applique uniquement aux graphiques linéaires.
public bool HasHiLoLines { get; set; }Valeur de propriété
HasLeaderLines
Vrai si la série a des lignes de leader.
public bool HasLeaderLines { get; set; }Valeur de propriété
HasRadarAxisLabels
Vrai si un graphique radar a des étiquettes d’axe de catégorie. S’applique uniquement aux graphiques radar.
public bool HasRadarAxisLabels { get; set; }Valeur de propriété
HasSeriesLines
Vrai si un graphique à colonnes empilées ou un graphique à barres a des lignes de séries ou si un graphique de tarte de tarte ou un graphique de barres de tarte a des lignes de connexion entre les deux sections. S’applique uniquement aux graphiques à colonnes empilées, graphiques à barres, graphiques de tarte de tarte ou graphiques de barres de tarte.
public bool HasSeriesLines { get; set; }Valeur de propriété
HasUpDownBars
Vrai si un graphique linéaire a des barres montantes et descendantes. S’applique uniquement aux graphiques linéaires.
public bool HasUpDownBars { get; set; }Valeur de propriété
HiLoLines
Renvoie un objet HiLoLines qui représente les lignes hautes-basses pour une série sur un graphique linéaire. S’applique uniquement aux graphiques linéaires.
public Line HiLoLines { get; }Valeur de propriété
IsAutoSplit
Indique si la valeur seuil est automatique.
public bool IsAutoSplit { get; }Valeur de propriété
IsColorVaried
Représente si la couleur des points varie. Le graphique doit contenir une seule série.
public bool IsColorVaried { get; set; }Valeur de propriété
IsFiltered
Indique si la série est sélectionnée ou filtrée. Vrai signifie que cette série est filtrée et ne sera pas affichée sur le graphique.
public bool IsFiltered { get; set; }Valeur de propriété
IsVerticalValues
Indique si la source de données est verticale.
public bool IsVerticalValues { get; }Valeur de propriété
LayoutProperties
Représente les propriétés de mise en page.
public SeriesLayoutProperties LayoutProperties { get; }Valeur de propriété
LeaderLines
Représente les lignes de leader sur un graphique. Les lignes de leader relient les étiquettes de données aux points de données. Cet objet n’est pas une collection ; il n’y a pas d’objet qui représente une seule ligne de leader.
public Line LeaderLines { get; }Valeur de propriété
LegendEntry
Obtient l’entrée de légende correspondant à cette série.
public LegendEntry LegendEntry { get; }Valeur de propriété
Marker
Obtient le marqueur Aspose.Cells.Charts.Series.Marker?text=marker.
public Marker Marker { get; }Valeur de propriété
Name
Obtient ou définit le nom de la série de données.
public string Name { get; set; }Exemples
//Référence du nom à une cellule
chart.NSeries[0].Name = "=A1";
//Définir une chaîne comme nom
chart.NSeries[0].Name = "Première série";'Référence du nom à une cellule
chart.NSeries[0].Name = "=A1"
'Définir une chaîne comme nom
chart.NSeries[0].Name = "Première série"Overlap
Spécifie comment les barres et les colonnes sont positionnées. Peut être une valeur comprise entre – 100 et 100. S’applique uniquement aux graphiques à barres 2-D et aux graphiques à colonnes 2-D.
public short Overlap { get; set; }Valeur de propriété
PlotOnSecondAxis
Indique si cette série est tracée sur le deuxième axe de valeur.
public bool PlotOnSecondAxis { get; set; }Valeur de propriété
Points
Obtient la collection de points dans une série dans un graphique.
public ChartPointCollection Points { get; }Valeur de propriété
Remarques
Lorsque le graphique est un graphique de tarte de tarte ou un graphique de barres de tarte, le dernier point est un autre point dans le premier tracé de tarte.
SecondPlotSize
Renvoie ou définit la taille de la section secondaire d’un graphique de tarte de tarte ou d’un graphique de barres de tarte, en pourcentage de la taille de la tarte primaire. Peut être une valeur de 5 à 200.
public short SecondPlotSize { get; set; }Valeur de propriété
SeriesLines
Renvoie un objet SeriesLines qui représente les lignes de séries pour un graphique à barres empilées ou un graphique à colonnes empilées. S’applique uniquement aux graphiques à barres empilées et aux graphiques à colonnes empilées.
public Line SeriesLines { get; }Valeur de propriété
Shadow
Vrai si la série a une ombre.
public bool Shadow { get; set; }Valeur de propriété
ShapeProperties
Obtient l’objet Aspose.Cells.Drawing.ShapePropertyCollection qui contient les propriétés visuelles de forme de la série.
public ShapePropertyCollection ShapeProperties { get; }Valeur de propriété
ShowNegativeBubbles
Vrai si des bulles négatives sont affichées pour le groupe de graphiques. Valide uniquement pour les graphiques à bulles.
public bool ShowNegativeBubbles { get; set; }Valeur de propriété
SizeRepresents
Obtient ou définit ce que la taille de la bulle représente sur un graphique à bulles.
public BubbleSizeRepresents SizeRepresents { get; set; }Valeur de propriété
Remarques
BubbleSizeRepresents.SizeIsArea signifie que la valeur Aspose.Cells.Charts.Series.BubbleSizes est la surface de la bulle. BubbleSizeRepresents.SizeIsWidth signifie que la valeur Aspose.Cells.Charts.Series.BubbleSizes est la largeur de la bulle.
Smooth
Représente le lissage de la courbe. Vrai si le lissage de la courbe est activé pour le graphique linéaire ou le graphique de dispersion. S’applique uniquement aux graphiques linéaires et de dispersion reliés par des lignes.
public bool Smooth { get; set; }Valeur de propriété
SplitType
Renvoie ou définit une valeur qui détermine comment déterminer quels points de données se trouvent dans la seconde tarte ou barre sur un graphique de tarte de tarte ou de barres de tarte.
public ChartSplitType SplitType { get; set; }Valeur de propriété
SplitValue
Renvoie ou définit une valeur qui sera utilisée pour déterminer quels points de données se trouvent dans la seconde tarte ou barre sur un graphique de tarte de tarte ou de barres de tarte.
public double SplitValue { get; set; }Valeur de propriété
TrendLines
Renvoie toutes les lignes de tendance de cette série.
public TrendlineCollection TrendLines { get; }Valeur de propriété
Type
Obtient ou définit le type d’une série de données.
public ChartType Type { get; set; }Valeur de propriété
UpBars
Renvoie un objet DropBars qui représente les barres montantes sur un graphique linéaire. S’applique uniquement aux graphiques linéaires.
public DropBars UpBars { get; }Valeur de propriété
Values
Représente les valeurs Y de cette série de graphiques.
public string Values { get; set; }Valeur de propriété
ValuesFormatCode
Représente le code de format de la liste de nombres des valeurs.
public string ValuesFormatCode { get; set; }Valeur de propriété
XErrorBar
Représente la barre d’erreur en direction X de la série.
public ErrorBar XErrorBar { get; }Valeur de propriété
XValues
Représente les valeurs x de la série de graphiques.
public string XValues { get; set; }Valeur de propriété
XValuesFormatCode
Représente le code de format de la liste de nombres des valeurs X.
public string XValuesFormatCode { get; set; }Valeur de propriété
YErrorBar
Représente la barre d’erreur en direction Y de la série.
public ErrorBar YErrorBar { get; }Valeur de propriété
Méthodes
Move(int)
Déplace la série vers le haut ou vers le bas.
public void Move(int count)Paramètres
count int
Le nombre de déplacements vers le haut ou vers le bas. Déplacez la série vers le haut si cela est inférieur à zéro ; Déplacez la série vers le bas si cela est supérieur à zéro.
