Series

Series class

Encapsule l’objet qui représente une seule série de données dans un graphique.

public class Series

Propriétés

NomLa description
Area { get; }Représente la zone d’arrière-plan de l’objet Série.
Bar3DShapeType { get; set; }Obtient ou définit le type de forme 3D utilisé avec l’histogramme ou l’histogramme 3D.
Border { get; }Représente la bordure de l’objet Série.
BubbleScale { get; set; }Obtient ou définit le facteur d’échelle des bulles dans le groupe de graphiques spécifié. Il peut s’agir d’une valeur entière comprise entre 0 (zéro) et 300, correspondant à un pourcentage de la taille par défaut. S’applique uniquement aux graphiques à bulles.
BubbleSizes { get; set; }Obtient ou définit les valeurs de tailles de bulles de la série de graphiques.
CountOfDataValues { get; }Obtient le nombre de valeurs de données.
DataLabels { get; }Représente l’objet DataLabels pour l’ASeries spécifié.
DisplayName { get; }Obtient le nom de la série qui s’affiche sur le graphique du graphique.
DoughnutHoleSize { get; set; }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 %.
DownBars { get; }Renvoie unDropBars objet qui représente les barres vers le bas sur un graphique en courbes. S’applique uniquement aux graphiques en courbes.
DropLines { get; }Renvoie unLine objet qui représente les lignes de chute d’une série sur le graphique en courbes ou le graphique en aires. S’applique uniquement aux graphiques en courbes ou en aires.
Explosion { get; set; }La distance entre une tranche de camembert ouverte et le centre du camembert est exprimée en pourcentage du diamètre du camembert.
FirstSliceAngle { get; set; }Obtient ou définit l’angle de la première tranche de graphique à secteurs 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 à secteurs, à secteurs 3D et en anneau, de 0 à 360.
GapWidth { get; set; }Renvoie ou définit l’espace entre les groupes de barres ou de colonnes, sous forme de pourcentage de la largeur de la barre ou de la colonne. La valeur de cette propriété doit être comprise entre 0 et 500.
Has3DEffect { get; set; }Vrai si la série a une apparence tridimensionnelle. S’applique uniquement aux graphiques à bulles.
HasDropLines { get; set; }Vrai si le graphique comporte des lignes de chute. S’applique uniquement aux graphiques linéaires ou en aires.
HasHiLoLines { get; set; }Vrai si le graphique en courbes a des lignes haut-bas. S’applique uniquement aux graphiques en courbes.
HasLeaderLines { get; set; }Vrai si la série a des lignes de repère.
HasRadarAxisLabels { get; set; }Vrai si un graphique en radar a des étiquettes d’axe des catégories. S’applique uniquement aux cartes radar.
HasSeriesLines { get; set; }Vrai si un histogramme empilé ou un graphique à barres comporte des lignes de série ou si un graphique à secteurs ou à barres comporte des lignes de connexion entre les deux sections. S’applique uniquement aux graphiques à colonnes empilées, aux graphiques à barres, aux graphiques à secteurs ou aux graphiques à barres.
HasUpDownBars { get; set; }Vrai si un graphique en courbes comporte des barres vers le haut et vers le bas. S’applique uniquement aux graphiques en courbes.
HiLoLines { get; }Renvoie un objet HiLoLines qui représente les lignes haut-bas d’une série sur un graphique en courbes. S’applique uniquement aux graphiques en courbes.
IsAutoSplit { get; }Indique si la valeur seuil est automatique.
IsColorVaried { get; set; }Représente si la couleur des points est variée. Le graphique ne doit contenir qu’une seule série.
IsVerticalValues { get; }Indique si la source de données est verticale.
LayoutProperties { get; }Représente les propriétés de mise en page.
LeaderLines { get; }Représente les lignes de repère sur un graphique. Les lignes de repère relient les étiquettes de données aux points de données. Cet objet n’est pas une collection ; aucun objet ne représente une seule ligne de repère.
LegendEntry { get; }Obtient l’entrée de légende selon cette série.
Marker { get; }Obtient lemarqueur .
Name { get; set; }Obtient ou définit le nom de la série de données.
Overlap { get; set; }Spécifie le positionnement des barres et des colonnes. Peut être une valeur comprise entre – 100 et 100. S’applique uniquement aux graphiques à barres 2D et à colonnes 2D.
PlotOnSecondAxis { get; set; }Indique si cette série est tracée sur le deuxième axe des valeurs.
Points { get; }Obtient la collection de points d’une série dans un graphique.
SecondPlotSize { get; set; }Renvoie ou définit la taille de la section secondaire d’un camembert ou d’une barre de camembert, sous forme de pourcentage de la taille du camembert principal. Peut être une valeur comprise entre 5 et 200.
SeriesLines { get; }Renvoie un objet SeriesLines qui représente les lignes de série d’un histogramme empilé ou d’un histogramme empilé. S’applique uniquement aux histogrammes empilés et aux histogrammes empilés.
Shadow { get; set; }Vrai si la série a une ombre.
ShapeProperties { get; }Obtient le objet qui contient les propriétés de forme visuelle de la série.
ShowNegativeBubbles { get; set; }Vrai si des bulles négatives sont affichées pour le groupe de graphiques. Valable uniquement pour les graphiques à bulles.
SizeRepresents { get; set; }Obtient ou définit ce que la taille de la bulle représente sur un graphique à bulles.
Smooth { get; set; }Représente le lissage de courbe. Vrai si le lissage des courbes est activé pour le graphique linéaire ou le graphique en nuage de points. S’applique uniquement aux graphiques linéaires et en nuage de points connectés par des graphiques linéaires.
SplitType { get; set; }Renvoie ou définit une valeur permettant de déterminer quels points de données se trouvent dans le deuxième graphique à secteurs ou à barres d’un graphique à secteurs ou à barres de graphique à secteurs.
SplitValue { get; set; }Renvoie ou définit une valeur qui doit être utilisée pour déterminer quels points de données se trouvent dans le deuxième camembert ou barre sur un camembert ou une barre de camembert.
TrendLines { get; }Renvoie un objet qui représente une collection de toutes les courbes de tendance de la série.
Type { get; set; }Obtient ou définit le type d’une série de données.
UpBars { get; }Renvoie un objet DropBars qui représente les barres supérieures d’un graphique en courbes. S’applique uniquement aux graphiques en courbes.
Values { get; set; }Représente les données de la série de graphiques.
ValuesFormatCode { get; set; }Représente le code de format de la liste de nombres de valeurs.
XErrorBar { get; }Représente la barre d’erreur de direction X de la série.
XValues { get; set; }Représente les valeurs x de la série de graphiques.
YErrorBar { get; }Représente la barre d’erreur de direction Y de la série.

Méthodes

NomLa description
Move(int)Déplace la série vers le haut ou vers le bas.

Exemples


[C#]

//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 feuille de calcul nouvellement ajoutée en passant son index de feuille
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Ajout d'un exemple de valeur à la cellule "A1"
worksheet.Cells["A1"].PutValue(50);
//Ajout d'un exemple de valeur à la cellule "A2"
worksheet.Cells["A2"].PutValue(100);
//Ajout d'un exemple de valeur à la cellule "A3"
worksheet.Cells["A3"].PutValue(150);
//Ajout d'un exemple de valeur à la cellule "A4"
worksheet.Cells["A4"].PutValue(200);
//Ajout d'un exemple de valeur à la cellule "B1"
worksheet.Cells["B1"].PutValue(60);
//Ajout d'un exemple de valeur à la cellule "B2"
worksheet.Cells["B2"].PutValue(32);
//Ajout d'un exemple de valeur à la cellule "B3"
worksheet.Cells["B3"].PutValue(50);
//Ajout d'un exemple de valeur à la cellule "B4"
worksheet.Cells["B4"].PutValue(40);
//Ajout d'un exemple de valeur à la cellule "C1" en tant que données de catégorie
worksheet.Cells["C1"].PutValue("Q1");
//Ajout d'un exemple de valeur à la cellule "C2" en tant que données de catégorie
worksheet.Cells["C2"].PutValue("Q2");
//Ajout d'un exemple de valeur à la cellule "C3" en tant que données de catégorie
worksheet.Cells["C3"].PutValue("Y1");
//Ajout d'un exemple de valeur à la cellule "C4" en tant que 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éder à 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"
int seriesIndex = 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";
Series series = chart.NSeries[seriesIndex];
//Définition des valeurs de la série.
series.Values = "=B1:B4";
// Modification du type de graphique de la série.
series.Type = ChartType.Line;
//Définition des 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 vos affaires

//Enregistrement du fichier Excel
workbook.Save("book1.xls");

[Visual Basic]

'Instanciation d'un objet Workbook
Dim workbook As Workbook = New Workbook()
'Ajout d'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)
'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")
'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)
'Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B4"
Dim seriesIndex As Int32 = 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"
Dim series As Series = chart.NSeries(seriesIndex)
'Réglage des valeurs de la série.
series.Values = "=B1:B4"
'Modification du type de graphique de la série.
series.Type = ChartType.Line
'Définition des 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
'Enregistrement du fichier Excel
workbook.Save("book1.xls")

Voir également

QuartileCalculationType SeriesCollection