Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Expand]WinForms Controls
[Collapse]ASP.NET Controls and MVC Extensions
 [Expand]Prerequisites
 [Expand]What's Installed
 [Expand]Common Concepts
 [Collapse]ASP.NET WebForms Controls
  [Expand]Reporting
  [Collapse]Chart Control
   [Expand]Product Information
   [Expand]Getting Started
   [Expand]Fundamentals
   [Collapse]Concepts
    [Collapse]Creating Charts
     [Collapse]2D Chart Types
       Area Chart
       Bubble Chart
       Candle Stick Chart
       Doughnut Chart
       Nested Doughnut Chart
       Full-Stacked Area Chart
       Full-Stacked Bar Chart
       Full-Stacked Line Chart
       Full-Stacked Spline Area Chart
       Funnel Chart
       Line Chart
       Overlapped Gantt Chart
       Overlapped Range Bar Chart
       Pie Chart
       Point Chart
       Polar Area Chart
       Polar Line Chart
       Polar Point Chart
       Radar Area Chart
       Radar Line Chart
       Radar Point Chart
       Range Area Chart
       Scatter Line Chart
       Scatter Polar Line Chart
       Scatter Radar Line Chart
       Side-by-Side Bar Chart
       Side-by-Side Full-Stacked Bar Chart
       Side-by-Side Gantt Chart
       Side-by-Side Range Bar Chart
       Side-by-Side Stacked Bar Chart
       Spline Area Chart
       Spline Chart
       Stacked Area Chart
       Stacked Bar Chart
       Stacked Line Chart
       Stacked Spline Area Chart
       Step Area Chart
       Step Line Chart
       Stock Chart
       Swift Plot
     [Expand]3D Chart Types
     [Expand]Providing Data
     [Expand]Data Representation
     [Expand]Appearance Customization
     [Expand]Miscellaneous
    [Expand]Chart Elements
    [Expand]End-User Interaction
     Supported Browsers
     Adding a Web Chart
     Handling Client-side Scripts
     Medium Trust Support
     Web Farm and Web Gardens Support
   [Expand]Design-Time Features
   [Expand]Visual Elements
   [Expand]Examples
  [Expand]Grid View
  [Expand]Card View
  [Expand]Vertical Grid
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Image and Data Browsing
  [Expand]Docking and Popups
  [Expand]Site Navigation and Layout
  [Expand]File Management
  [Expand]Multi-Use Site Controls
  [Expand]Scheduler
  [Expand]HTML Editor
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gauges
  [Expand]Data Editors
  [Expand]Spell Checker
  [Expand]Query Builder
 [Expand]ASP.NET MVC Extensions
 [Expand]Localization
 [Expand]Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Doughnut Chart

Expanded Short Description

The Doughnut Chart is represented by the DoughnutSeriesView object, which belongs to Pie, Doughnut and Funnel Series Views. This view is useful when it is necessary to compare the percentage values of different point arguments in the same series, and to illustrate these values as easy to understand pie slices, but with a hole in the center.

A Doughnut chart is shown in the image below. Note that if a chart contains several series of the DoughnutSeriesView type (as well as PieSeriesView), all series are displayed in the same diagram according to the SimpleDiagram.Dimension and SimpleDiagram.LayoutDirection property values.

Use the DoughnutSeriesView.HoleRadiusPercent (or Doughnut3DSeriesView.HoleRadiusPercent) property to control the size of the doughnut's hole. For example, in the above image, this property is set to 0 for the left chart.

Expanded Chart Type Characteristics

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

Feature

Value

Series View type DoughnutSeriesView
Diagram type 2D-SimpleDiagram
Number of arguments per series point 1
Number of values per series point 1
Note

For information on which chart types can be combined with the Doughnut Chart, refer to the Combining Different Series Views document.

Expanded Example

Show Me

A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=E1047.

The following example demonstrates how to create a ChartControl with a series of the DoughnutSeriesView type, set its general properties, and add this chart to a form at runtime. Before proceeding with this example, create a Windows Forms Application in Visual Studio, and add all required assemblies to the References list of your project.

Then, add the following code to the Form.Load event handler.

Show Me

A complete sample project is available in the DevExpress Code Examples database at http://www.devexpress.com/example=E1047.

Expanded See Also

How would you rate this topic?​​​​​​​