ChartSeries

ChartSeries class

Stellt Diagrammserieneigenschaften dar.

Um mehr zu erfahren, besuchen Sie dieArbeiten mit Diagrammen Dokumentationsartikel.

public class ChartSeries : IChartDataPoint

Eigenschaften

Name	Beschreibung
Bubble3D { get; set; }	Gibt an, ob auf die Blasen im Blasendiagramm ein 3D-Effekt angewendet werden soll.
BubbleSizes { get; }	Ruft eine Sammlung von Blasengrößen für diese Diagrammserie ab.
DataLabels { get; }	Gibt die Einstellungen für die Datenbeschriftungen für die gesamte Serie an.
DataPoints { get; }	Gibt eine Sammlung von Formatierungsobjekten für alle Datenpunkte in dieser Serie zurück.
Explosion { get; set; }	Gibt den Betrag an, um den der Datenpunkt von der Mitte des Kreises verschoben werden soll. Kann negativ sein. Negativ bedeutet, dass die Eigenschaft nicht festgelegt ist und keine Explosion angewendet werden soll. Gilt nur für Kreisdiagramme.
Format { get; }	Bietet Zugriff auf die Füll- und Zeilenformatierung der Serie.
HasDataLabels { get; set; }	Ruft ein Flag ab oder setzt es, das angibt, ob Datenbeschriftungen für die Serie angezeigt werden.
InvertIfNegative { get; set; }	Gibt an, ob das übergeordnete Element seine Farben invertieren soll, wenn der Wert negativ ist.
LegendEntry { get; }	Ruft einen Legendeneintrag für diese Diagrammserie ab.
Marker { get; }	Gibt einen Datenmarker an. Marker wird bei Anforderung automatisch erstellt.
Name { get; set; }	Ruft den Namen der Serie ab oder legt ihn fest. Wenn der Name nicht explizit festgelegt wird, wird er mithilfe von index. generiert. Standardmäßig wird Series plus eins basierend auf index. zurückgegeben.
SeriesType { get; }	Ruft den Typ dieser Diagrammreihe ab.
Smooth { get; set; }	Ermöglicht die Angabe, ob die Linie, die die Punkte im Diagramm verbindet, mithilfe von Catmull-Rom-Splines geglättet werden soll.
XValues { get; }	Ruft eine Sammlung von X-Werten für diese Diagrammreihe ab.
YValues { get; }	Ruft eine Sammlung von Y-Werten für diese Diagrammreihe ab.

Methoden

Name	Beschreibung
Add(ChartXValue)	Fügt den angegebenen X-Wert zur Diagrammreihe hinzu. Wenn die Reihe Y-Werte und Blasengrößen unterstützt, sind diese für den X-Wert leer.
Add(ChartXValue, ChartYValue)	Fügt die angegebenen X- und Y-Werte zur Diagrammreihe hinzu.
Add(ChartXValue, ChartYValue, double)	Fügt den angegebenen X-Wert, Y-Wert und die Blasengröße zur Diagrammreihe hinzu.
Clear()	Entfernt alle Datenwerte aus der Diagrammreihe. Das Format aller einzelnen Datenpunkte und Datenbeschriftungen wird gelöscht.
ClearValues()	Entfernt alle Datenwerte aus der Diagrammreihe unter Beibehaltung des Formats der Datenpunkte und Datenbeschriftungen.
Insert(int, ChartXValue)	Fügt den angegebenen X-Wert am angegebenen Index in die Diagrammreihe ein. Wenn die Reihe Y-Werte und Blasengrößen unterstützt, sind diese für den X-Wert leer.
Insert(int, ChartXValue, ChartYValue)	Fügt die angegebenen X- und Y-Werte am angegebenen Index in die Diagrammreihe ein.
Insert(int, ChartXValue, ChartYValue, double)	Fügt den angegebenen X-Wert, Y-Wert und die Blasengröße am angegebenen Index in die Diagrammreihe ein.
Remove(int)	Entfernt den X-Wert, den Y-Wert und die Blasengröße, sofern unterstützt, aus der Diagrammreihe am angegebenen Index. Der entsprechende Datenpunkt und die Datenbeschriftung werden ebenfalls entfernt.

Beispiele

Zeigt, wie Beschriftungen auf Datenpunkte in einem Liniendiagramm angewendet werden.

public void DataLabels()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    Shape chartShape = builder.InsertChart(ChartType.Line, 400, 300);
    Chart chart = chartShape.Chart;

    Assert.AreEqual(3, chart.Series.Count);
    Assert.AreEqual("Series 1", chart.Series[0].Name);
    Assert.AreEqual("Series 2", chart.Series[1].Name);
    Assert.AreEqual("Series 3", chart.Series[2].Name);

    // Anwenden von Datenbeschriftungen auf jede Reihe im Diagramm.
    // Diese Beschriftungen werden neben jedem Datenpunkt im Diagramm angezeigt und zeigen seinen Wert an.
    foreach (ChartSeries series in chart.Series)
    {
        ApplyDataLabels(series, 4, "000.0", ", ");
        Assert.AreEqual(4, series.DataLabels.Count);
    }

    // Ändern Sie die Trennzeichenfolge für jede Datenbeschriftung in einer Reihe.
    using (IEnumerator<ChartDataLabel> enumerator = chart.Series[0].DataLabels.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.AreEqual(", ", enumerator.Current.Separator);
            enumerator.Current.Separator = " & ";
        }
    }

    // Für ein übersichtlicheres Diagramm können wir Datenbeschriftungen einzeln entfernen.
    chart.Series[1].DataLabels[2].ClearFormat();

    // Wir können auch eine ganze Reihe ihrer Datenbeschriftungen auf einmal entfernen.
    chart.Series[2].DataLabels.ClearFormat();

    doc.Save(ArtifactsDir + "Charts.DataLabels.docx");
}

/// <summary>
/// Datenbeschriftungen mit benutzerdefiniertem Zahlenformat und Trennzeichen auf mehrere Datenpunkte in einer Reihe anwenden.
/// </summary>
private static void ApplyDataLabels(ChartSeries series, int labelsCount, string numberFormat, string separator)
{
    for (int i = 0; i < labelsCount; i++)
    {
        series.HasDataLabels = true;

        Assert.False(series.DataLabels[i].IsVisible);

        series.DataLabels[i].ShowCategoryName = true;
        series.DataLabels[i].ShowSeriesName = true;
        series.DataLabels[i].ShowValue = true;
        series.DataLabels[i].ShowLeaderLines = true;
        series.DataLabels[i].ShowLegendKey = true;
        series.DataLabels[i].ShowPercentage = false;
        series.DataLabels[i].IsHidden = false;
        Assert.False(series.DataLabels[i].ShowDataLabelsRange);

        series.DataLabels[i].NumberFormat.FormatCode = numberFormat;
        series.DataLabels[i].Separator = separator;

        Assert.False(series.DataLabels[i].ShowDataLabelsRange);
        Assert.True(series.DataLabels[i].IsVisible);
        Assert.False(series.DataLabels[i].IsHidden);
    }
}

Siehe auch

ChartNumberFormat Class ChartSeriesCollection Class