Reihen und Datenpunkte (Diagrammsteuerelemente)

Artikel
02/27/2011

Die Chart.Series-Auflistung enthält alle Datenreihen (Series-Objekte) im Diagrammsteuerelement. Jeder Reihe sind folgende Eigenschaften zugewiesen:

Ein Diagrammtyp (die Series.ChartType-Eigenschaft)
Eine Diagrammfläche (die Series.ChartArea-Eigenschaft)
Eine Legende, falls zutreffend (die Series.Legend-Eigenschaft)
Eine X-Achse (die Series.XAxisType-Eigenschaft)
Eine Y-Achse (die Series.XAxisType-Eigenschaft)

Jede Reihe beinhaltet eine Auflistung von DataPoint-Objekten (die Series.Points-Auflistungseigenschaft). Jeder Datenpunkt enthält folgende Eigenschaften:

Einen X-Wert (die DataPoint.XValue-Eigenschaft)
Ein oder mehrere Y-Werte (die DataPoint.YValues-Eigenschaft)

Das Series-Objekt und das DataPoint-Objekt enthalten Darstellungseigenschaften für Bezeichnungen, Marker und leere Punkte. Weitere Informationen finden Sie unter Diagrammdarstellung (Diagrammsteuerelemente).

Als Sie diese Eigenschaften in einer Reihe festlegen, übernehmen alle Datenpunkte in der Reihe die gleichen Einstellungen. Wenn Sie Eigenschaften in einem bestimmten Datenpunkt festlegten, haben diese Einstellungen Vorrang vor den Einstellungen in der Reihe.

Hinzufügen von Reihen und Daten zur Laufzeit

Um dem Diagrammsteuerelement zur Laufzeit eine Reihe hinzuzufügen, verwenden Sie die Add-Methode in der Chart.Series-Auflistungseigenschaft. Um einer Reihe zur Laufzeit einen Datenpunkt hinzuzufügen, verwenden Sie die Methoden Add, AddXY und AddY in der Series.Points-Auflistungseigenschaft.

Im folgenden Code wird dem Diagrammbild eine Reihe vom Typ "Säule" und ein Datenpunkt hinzugefügt. Anschließend wird das Diagrammbild in "ChartArea1" gezeichnet.

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";

Zeichnen mehrerer Reihen in einer Diagrammfläche

Wenn Sie der gleichen Diagrammfläche mehrere Reihe zuweisen, versucht diese, die Reihen zusammen zu zeichnen. Hierzu werden die folgenden Techniken verwendet:

Stapel
Reihen mit stapelbaren Diagrammtypen werden übereinander gestapelt. Beispiel: Gestapeltes Balkendiagramm.
Cluster
Reihen, die nebeneinander gezeichnet werden können, wird nebeneinander gezeichnet. Beispiel: Balkendiagramm.
Überlappung
Wenn Reihen Diagrammtypen aufweisen, die weder gestapelt noch nebeneinander angeordnet werden können, überlappen sich diese entsprechend der Indexreihenfolge in der Chart.Series-Auflistung. Die Reihe bei Index 0 wird zuerst gezeichnet, gefolgt von der Reihe bei Index 1, die diese überlappt, usw.

Tipp

Kreisförmige Diagrammtypen und Pyramiden- sowie Trichterdiagramme lassen nur eine Reihe pro Diagrammfläche zu. Alle anderen Diagrammtypen können mit kompatiblen Diagrammtypen gezeichnet werden. Weitere Informationen finden Sie unter Diagrammtypen.

Um eine korrekte Überlappung sicherzustellen, wenn Sie Reihen gemeinsam zeichnen, muss die im Vordergrund anzuzeigende Reihe eine höhere Indexnummer als die anderen Reihen in der Chart.Series-Auflistung haben.

Indizieren von X-Werten

Sie können die X-Werte einer Reihe in der Zeichnungsfläche indizieren. Standardmäßig zeichnet das Diagrammsteuerelement eine Reihe in aufsteigender Reihenfolge der X-Werte. Wenn Sie die Series.IsXValueIndexed-Eigenschaft auf true festlegen, verwendet das Diagrammsteuerelement stattdessen die Indexreihenfolge der Datenpunkte in der Series.Points-Auflistungseigenschaft.

Dies ist nützlich, wenn die X-Werte der Reihe irrelevant sind und Sie keine Lücken in den gezeichneten Daten aufgrund von Lücken in den X-Werten anzeigen möchten.

Tipp

Wenn Sie die Series.IsXValueIndexed-Eigenschaft auf true festlegen, werden alle Reihen indiziert, die der gleichen Diagrammfläche und (primären oder sekundären) X-Achse zugewiesen sind. Sie müssen sicherstellen, dass die Reihe ausgerichtet ist. Andernfalls löst das Diagrammsteuerelement eine Ausnahme aus. Weitere Informationen finden Sie unter Ausrichten von Daten.

Verwenden von Schlüsselwörtern

Sie können Schlüsselwörter für Bezeichnungen, Legenden und QuickInfos in einer Reihe oder einem Datenpunkt verwenden, z. B. die Series.Tooltip-Eigenschaft. Weitere Informationen zu Schlüsselwörtern finden Sie unter Schlüsselwörter.

Verwenden von benutzerdefinierten Eigenschaften

Abhängig von dem für eine Reihe ausgewählten Diagrammtyp können Sie auf bestimmte benutzerdefinierte Eigenschaften zugreifen und anpassen, wie die Datenreihe gezeichnet wird. Verwenden Sie hierfür die CustomProperties-Eigenschaft im Series-Objekt oder DataPoint-Objekt. Weitere Informationen finden Sie unter Benutzerdefinierte Eigenschaften.