Skip to main content

Pie Chart

  • 4 minutes to read

Short Description

The Pie Chart is represented by the PieSeriesView object, which belongs to Pie, Doughnut and Funnel Series Views. This view allows you to compare the percentage values of different point arguments in the same series, and to illustrate these values as easy-to-understand pie slices.

A Pie chart is shown in the image below. Note that if a chart contains multiple series of the PieSeriesView type, all series are displayed in the same diagram based on the SimpleDiagram.Dimension and SimpleDiagram.LayoutDirection property values.


Chart Type Characteristics

The table below lists the main characteristics of this chart type.

Feature Value
Series View type PieSeriesView
Diagram type 2D-SimpleDiagram
Number of arguments per series point 1
Number of values per series point 1


For information on which chart types can be combined with the Pie Chart, refer to the following help topic: Combining Different Series Views.


The following example creates a WebChartControl with a series of the PieSeriesView type and adds this chart to a form at runtime.

Pie chart

Before proceeding with this example, create a Web Forms Application in Visual Studio, and add all required assemblies to the project’s References list.

Then, add the following code to the page’s Load event handler:

using DevExpress.XtraCharts;
using DevExpress.XtraCharts.Web;
using System;
using System.Collections.Generic;

namespace PieChartSample {
    public partial class WebForm1 : System.Web.UI.Page {
        protected void Page_Load(object sender, EventArgs e) {
            // Create a WebChartControl instance:
            WebChartControl chart = new WebChartControl();
            chart.RenderFormat = RenderFormat.Svg;
            chart.Height = 450;
            chart.Width = 800;

            // Specify the chart palette:
            chart.PaletteName = Palettes.Slipstream.Name;

            // Create a Pie series and bind it to data:
            Series series = new Series("Pie", ViewType.Pie);
            series.DataSource = DataPoint.GetDataPoints();
            series.SetDataMembers("Argument", "Value");

            // Format series labels:
            series.Label.TextPattern = "{VP:p0} ({V:.##}M km²)";

            // Format series legend items:
            series.LegendTextPattern = "{A}";

            // Adjust series label position:
            ((PieSeriesLabel)series.Label).Position = PieSeriesLabelPosition.TwoColumns;

            // Resolve label overlaps:
            ((PieSeriesLabel)series.Label).ResolveOverlappingMode = ResolveOverlappingMode.Default;

            // Access series view options:
            PieSeriesView seriesView = (PieSeriesView)series.View;

            // Specify a data filter to explode points:
            seriesView.ExplodedPointsFilters.Add(new SeriesPointFilter(SeriesPointKey.Value_1,
                DataFilterCondition.GreaterThanOrEqual, 9));
            seriesView.ExplodedPointsFilters.Add(new SeriesPointFilter(SeriesPointKey.Argument,
                DataFilterCondition.NotEqual, "Others"));
            seriesView.ExplodeMode = PieExplodeMode.UseFilters;
            seriesView.ExplodedDistancePercentage = 30;
            seriesView.RuntimeExploding = true;

    public class DataPoint {
        public string Argument { get; set; }
        public double Value { get; set; }
        public static List<DataPoint> GetDataPoints() {
            return new List<DataPoint> {
                    new DataPoint { Argument = "Russia",    Value = 17.0752},
                    new DataPoint { Argument = "Canada",    Value = 9.98467},
                    new DataPoint { Argument = "USA",       Value = 9.63142},
                    new DataPoint { Argument = "China",     Value = 9.59696},
                    new DataPoint { Argument = "Brazil",    Value = 8.511965},
                    new DataPoint { Argument = "Australia", Value = 7.68685},
                    new DataPoint { Argument = "India",     Value = 3.28759},
                    new DataPoint { Argument = "Others",    Value = 81.2}
See Also