Séries et points de données dans les contrôles Chart
La collection Chart.Series contient toutes les séries de données (objets Series) du contrôle Chart.Les éléments suivants sont affectés à chaque série :
un type de graphique (propriété Series.ChartType) ;
une zone de graphique (propriété Series.ChartArea) ;
une légende (propriété Series.Legend), le cas échéant ;
un axe des X (propriété Series.XAxisType) ;
un axe des Y (propriété Series.XAxisType).
Chaque série contient une collection d'objets DataPoint (propriété de collection Series.Points).Chaque point de données contient :
une valeur X (propriété DataPoint.XValue) ;
une ou plusieurs valeurs Y (propriété DataPoint.YValues).
Les objets Series et DataPoint contiennent des propriétés d'apparence pour les étiquettes, les marqueurs et les points vides.Pour plus d'informations, consultez Apparence des graphiques.
Lorsque vous définissez ces propriétés dans une série, tous les points de données de cette série héritent des mêmes paramètres.Si vous définissez des propriétés dans un point de données particulier, ces paramètres sont prioritaires sur ceux de la série.
Ajout de séries et de données au moment de l'exécution
Pour ajouter une série au contrôle Chart au moment de l'exécution, utilisez la méthode Add de la propriété de collection Chart.Series.Pour ajouter un point de données à une série au moment de l'exécution, utilisez les méthodes Add, AddXY et AddY de la propriété de collection Series.Points.
Le code suivant ajoute une série de type histogramme à l'image du graphique, ajoute un point de données et le trace dans ChartArea1.
Chart1.Series.Add("Series2")
Chart1.Series("Series2").ChartType = SeriesChartType.Column
Chart1.Series("Series2").Points.AddY(20)
Chart1.Series("Series2").ChartArea = "ChartArea1"
Chart1.Series.Add("Series2");
Chart1.Series["Series2"].ChartType = SeriesChartType.Column;
Chart1.Series["Series2"].Points.AddY(20);
Chart1.Series["Series2"].ChartArea = "ChartArea1";
Traçage de plusieurs séries dans une zone de graphique
Lorsque vous affectez plusieurs séries à la même zone de graphique, celle-ci essaie de tracer les séries ensemble.Elle utilise les techniques suivantes :
Pile
Dans les types de graphiques qui peuvent être empilés, les séries sont empilées les unes sur les autres.C'est par exemple le cas du graphique à barres empilées.Cluster
Les séries qui peuvent être tracées en regard les unes des autres sont tracées côte à côte.C'est par exemple le cas du graphique à barres.Chevauchement
Si les séries appartiennent à des types de graphiques qui ne peuvent être ni empilés, ni mis en cluster, elles se chevauchent selon leur ordre d'index dans la collection Chart.Series.La série située à l'index 0 est tracée en premier, puis la série située à l'index 1 la chevauche, et ainsi de suite.
Notes
Les types de graphiques en forme de cercle, en pyramide et en entonnoir n'autorisent qu'une série par zone de graphique.Chacun des autres types de graphiques peut être tracé avec des types de graphiques compatibles.Pour plus d'informations, consultez Types de graphiques.
Lorsque plusieurs séries sont tracées ensemble, vous devez, pour que le chevauchement soit correct, veiller à ce que les séries censées apparaître devant aient un numéro d'index supérieur aux autres séries dans la collection Chart.Series.
Indexation de valeurs X
Vous pouvez indexer les valeurs X d'une série dans la zone de traçage.Par défaut, le contrôle Chart trace une série dans l'ordre croissant des valeurs X.Si vous affectez à la propriété Series.IsXValueIndexed la valeur true, le contrôle Chart utilise à la place l'ordre d'index des points de données de la propriété de collection Series.Points.
Cela se révèle utile lorsque les valeurs X de la série ne sont pas importantes et que vous ne souhaitez pas voir d'écarts entre les données tracées en raison des intervalles des valeurs X.
Notes
Affecter à la propriété Series.IsXValueIndexed la valeur true entraîne l'indexation de toutes les séries affectées aux mêmes zone de graphique et axe des X (principal ou secondaire).Vous devez vous assurer que les séries sont alignées.Sinon, le contrôle Chart lève une exception.Pour plus d'informations, consultez Alignement des données.
Utilisation de mots clés
Vous pouvez utiliser des mots clés pour les étiquettes, légendes et info-bulles d'une série ou d'un point de données, par exemple, la propriété Series.Tooltip.Pour plus d'informations sur les mots clés, consultez Mots clés.
Utilisation de propriétés personnalisées
Selon le type de graphique que vous choisissez pour une série, vous pouvez accéder à certaines propriétés personnalisées afin de personnaliser la façon dont elle sera tracée.Pour cela, utilisez la propriété CustomProperties de l'objet Series ou DataPoint.Pour plus d'informations, consultez Propriétés personnalisées.
Voir aussi
Référence
System.Windows.Forms.DataVisualization.Charting
System.Web.UI.DataVisualization.Charting