ChartSeriesCollection

ChartSeriesCollection class

Represents collection of a ChartSeries.

To learn more, visit the Working with Charts documentation article.

public class ChartSeriesCollection : IEnumerable<ChartSeries>

Properties

NameDescription
Count { get; }Returns the number of ChartSeries in this collection.
Item { get; }Returns a ChartSeries at the specified index.

Methods

NameDescription
Add(string, double[])Adds new ChartSeries to this collection. Use this method to add series to Histogram charts.
Add(string, ChartMultilevelValue[], double[])Adds new ChartSeries to this collection. Use this method to add series that have multi-level data categories.
Add(string, DateTime[], double[])Adds new ChartSeries to this collection. Use this method to add series to any type of Area, Radar and Stock charts.
Add(string, double[], double[])Adds new ChartSeries to this collection. Use this method to add series to any type of Scatter charts.
Add(string, string[], double[])Adds new ChartSeries to this collection. Use this method to add series to any type of Bar, Column, Line and Surface charts.
Add(string, double[], double[], double[])Adds new ChartSeries to this collection. Use this method to add series to any type of Bubble charts.
Add(string, string[], double[], bool[])Adds new ChartSeries to this collection. Use this method to add series to Waterfall charts.
Clear()Removes all ChartSeries from this collection.
GetEnumerator()Returns an enumerator object.
RemoveAt(int)Removes a ChartSeries at the specified index.

Examples

Shows how to add and remove series data in a chart.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Insert a column chart that will contain three series of demo data by default.
Shape chartShape = builder.InsertChart(ChartType.Column, 400, 300);
Chart chart = chartShape.Chart;

// Each series has four decimal values: one for each of the four categories.
// Four clusters of three columns will represent this data.
ChartSeriesCollection chartData = chart.Series;

Assert.AreEqual(3, chartData.Count);

// Print the name of every series in the chart.
using (IEnumerator<ChartSeries> enumerator = chart.Series.GetEnumerator())
{
    while (enumerator.MoveNext())
    {
        Console.WriteLine(enumerator.Current.Name);
    }
}

// These are the names of the categories in the chart.
string[] categories = { "Category 1", "Category 2", "Category 3", "Category 4" };

// We can add a series with new values for existing categories.
// This chart will now contain four clusters of four columns.
chart.Series.Add("Series 4", categories, new[] { 4.4, 7.0, 3.5, 2.1 });
// A chart series can also be removed by index, like this.
// This will remove one of the three demo series that came with the chart.
chartData.RemoveAt(2);

Assert.False(chartData.Any(s => s.Name == "Series 3"));
// We can also clear all the chart's data at once with this method.
// When creating a new chart, this is the way to wipe all the demo data
// before we can begin working on a blank chart.
chartData.Clear();

See Also