ChartSeries

ChartSeries class

Representerar egenskaper för diagramserien.

För att lära dig mer, besökArbeta med diagram dokumentationsartikel.

public class ChartSeries : IChartDataPoint

Egenskaper

namnBeskrivning
Bubble3D { get; set; }Anger om bubblorna i bubbeldiagrammet ska ha en 3D-effekt.
BubbleSizes { get; }Hämtar en samling bubbelstorlekar för den här diagramserien.
DataLabels { get; }Anger inställningarna för dataetiketterna för hela serien.
DataPoints { get; }Returnerar en samling formateringsobjekt för alla datapunkter i den här serien.
Explosion { get; set; }Anger hur mycket datapunkten ska flyttas från cirkeldiagrammets mitt. Kan vara negativ, negativ betyder att egenskapen inte är angiven och ingen explosion ska tillämpas. Gäller endast cirkeldiagram.
Format { get; }Ger åtkomst till fyllnings- och linjeformatering av serien.
HasDataLabels { get; set; }Hämtar eller ställer in en flagga som anger om dataetiketter visas för serien.
InvertIfNegative { get; set; }Anger om förälderelementet ska invertera sina färger om värdet är negativt.
LegendEntry { get; }Hämtar en förklaringspost för den här diagramserien.
Marker { get; }Anger en datamarkör. Markören skapas automatiskt när den begärs.
Name { get; set; }Hämtar eller anger namnet på serien. Om namnet inte anges explicit genereras det med hjälp av index. Returnerar som standard serien plus ett baserat på index.
SeriesType { get; }Hämtar typen för denna diagramserie.
Smooth { get; set; }Gör det möjligt att ange om linjen som förbinder punkterna i diagrammet ska utjämnas med Catmull-Rom-splines.
XValues { get; }Hämtar en samling X-värden för denna diagramserie.
YValues { get; }Hämtar en samling Y-värden för denna diagramserie.

Metoder

namnBeskrivning
Add(ChartXValue)Lägger till det angivna X-värdet i diagramserien. Om serien stöder Y-värden och bubbelstorlekar kommer de att vara tomma för X-värdet.
Add(ChartXValueChartYValue)Lägger till de angivna X- och Y-värdena till diagramserien.
Add(ChartXValueChartYValue, double)Lägger till det angivna X-värdet, Y-värdet och bubbelstorleken till diagramserien.
Clear()Tar bort alla datavärden från diagramserien. Formatet för alla individuella datapunkter och dataetiketter rensas.
ClearValues()Tar bort alla datavärden från diagramserien och bevarar formatet för datapunkterna och dataetiketterna.
CopyFormatFrom(int)Kopierar standardformatet för datapunkten från datapunkten med det angivna indexet.
Insert(int, ChartXValue)Infogar det angivna X-värdet i diagramserien vid det angivna indexet. Om serien stöder Y-värden och bubbelstorlekar, kommer de att vara tomma för X-värdet.
Insert(int, ChartXValueChartYValue)Infogar de angivna X- och Y-värdena i diagramserien vid det angivna indexet.
Insert(int, ChartXValueChartYValue, double)Infogar det angivna X-värdet, Y-värdet och bubbelstorleken i diagramserien vid det angivna indexet.
Remove(int)Tar bort X-värdet, Y-värdet och bubbelstorleken, om det stöds, från diagramserien vid det angivna indexet. Motsvarande datapunkt och dataetikett tas också bort.

Exempel

Visar hur man applicerar etiketter på datapunkter i ett linjediagram.

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

    // Använd dataetiketter på varje serie i diagrammet.
    // Dessa etiketter visas bredvid varje datapunkt i grafen och visar dess värde.
    foreach (ChartSeries series in chart.Series)
    {
        ApplyDataLabels(series, 4, "000.0", ", ");
        Assert.AreEqual(4, series.DataLabels.Count);
    }

    // Ändra avgränsningssträngen för varje dataetikett i en serie.
    using (IEnumerator<ChartDataLabel> enumerator = chart.Series[0].DataLabels.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.AreEqual(", ", enumerator.Current.Separator);
            enumerator.Current.Separator = " & ";
        }
    }

    ChartDataLabel dataLabel = chart.Series[1].DataLabels[2];
    dataLabel.Format.Fill.Color = Color.Red;

    // För en renare graf kan vi ta bort dataetiketter individuellt.
    dataLabel.ClearFormat();

    // Vi kan också ta bort en hel serie av dess dataetiketter samtidigt.
    chart.Series[2].DataLabels.ClearFormat();

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

/// <summary>
/// Använd dataetiketter med anpassat talformat och avgränsare på flera datapunkter i en serie.
/// </summary>
private static void ApplyDataLabels(ChartSeries series, int labelsCount, string numberFormat, string separator)
{
    series.HasDataLabels = true;
    series.Explosion = 40;

    for (int i = 0; i < labelsCount; i++)
    {
        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;
        Assert.False(series.DataLabels[i].IsHidden);
        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);
    }
}

Se även