PieDashboardItem Class

A Pie dashboard item that displays a series of pies or donuts.

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v21.2.Core.dll

Declaration

C#

public class PieDashboardItem :
    ChartDashboardItemBase,
    IPieContext,
    IElementContainer

VB.NET

Public Class PieDashboardItem
    Inherits ChartDashboardItemBase
    Implements IPieContext,
               IElementContainer

Remarks

The Pie dashboard item displays a series of pies or donuts that represent the contribution of each value to the total.

The following documentation is available.

• WinForms Designer - Creating Pies
• Web Dashboard - Creating Pies

Example

The following example demonstrates how to bind a Pie dashboard item to data in code.

View Example: How to Bind a Pie Dashboard Item to Data at Runtime

Form1.cs

using DevExpress.DashboardCommon;
using System;
using System.Windows.Forms;

namespace Dashboard_CreatePies
{
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }
        private PieDashboardItem CreatePies(IDashboardDataSource dataSource) {
            PieDashboardItem pies = new PieDashboardItem();
            pies.DataSource = dataSource;
            pies.Values.Add(new Measure("Extended Price"));
            pies.Arguments.Add(new Dimension("Country"));
            pies.SeriesDimensions.Add(new Dimension("OrderDate"));
            return pies;
        }
        private void Form1_Load(object sender, EventArgs e) {
           DashboardExcelDataSource excelDataSource = new DashboardExcelDataSource()
            {
                FileName = "SalesPerson.xlsx",
                SourceOptions = new DevExpress.DataAccess.Excel.ExcelSourceOptions(
                    new DevExpress.DataAccess.Excel.ExcelWorksheetSettings()
                    {
                        WorksheetName = "Data",
                        CellRange = "A1:L100"
                    }
                )
            };
            excelDataSource.Fill();

            Dashboard dashBoard = new Dashboard();
            dashBoard.DataSources.Add(excelDataSource);
            PieDashboardItem pies = CreatePies(excelDataSource);
            dashBoard.Items.Add(pies);

            dashboardViewer1.Dashboard = dashBoard;
            dashboardViewer1.ReloadData();
        }
    }
}

Form1.vb

Imports DevExpress.DashboardCommon
Imports System
Imports System.Windows.Forms

Namespace Dashboard_CreatePies
    Partial Public Class Form1
        Inherits Form

        Public Sub New()
            InitializeComponent()
        End Sub
        Private Function CreatePies(ByVal dataSource As IDashboardDataSource) As PieDashboardItem
            Dim pies As New PieDashboardItem()
            pies.DataSource = dataSource
            pies.Values.Add(New Measure("Extended Price"))
            pies.Arguments.Add(New Dimension("Country"))
            pies.SeriesDimensions.Add(New Dimension("OrderDate"))
            Return pies
        End Function
        Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
            Dim excelDataSource As New DashboardExcelDataSource()
            excelDataSource.FileName = "SalesPerson.xlsx"
            Dim options As New DevExpress.DataAccess.Excel.ExcelSourceOptions()
            Dim importSettings = New DevExpress.DataAccess.Excel.ExcelWorksheetSettings()
            importSettings.WorksheetName = "Data"
            importSettings.CellRange = "A1:L100"
            options.ImportSettings = importSettings
            excelDataSource.SourceOptions = options
            excelDataSource.Fill()

            Dim dashBoard As New Dashboard()
            dashBoard.DataSources.Add(excelDataSource)
            Dim pies As PieDashboardItem = CreatePies(excelDataSource)
            dashBoard.Items.Add(pies)

            dashboardViewer1.Dashboard = dashBoard
            dashboardViewer1.ReloadData()
        End Sub
    End Class
End Namespace

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the PieDashboardItem class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

wpf-dashboard-viewer-item-tabs/CS/WpfDashboardTabSupportExample/WpfDashboardTabSupportExample/DashboardItemGenerator.cs#L38

{
    PieDashboardItem pieItem = new PieDashboardItem() { ComponentName = itemComponentName };
    pieItem.DataSource = dataSource;

winforms-dashboard-viewer-item-tabs/CS/TabSupportExample/DashboardItemGenerator.cs#L43

{
    PieDashboardItem pieItem = new PieDashboardItem() { ComponentName = itemComponentName };
    pieItem.DataSource = dataSource;

how-to-bind-a-pie-dashboard-item-to-data-in-code-e4769/CS/Dashboard_CreatePies/Form1.cs#L11

}
private PieDashboardItem CreatePies(IDashboardDataSource dataSource) {
    PieDashboardItem pies = new PieDashboardItem();

WinForms-Dashboard-How-to-export-customized-Pie-Dashboard-Item/CS/piesCustomExport/Form1.cs#L30

{
    PieDashboardItem pieItem = dashboardDesigner1.Dashboard.Items[e.DashboardItemName] as PieDashboardItem;
    if (pieItem == null) return;

how-to-customize-a-dashboard-color-scheme-t184002/CS/Dashboard_Coloring/Form1.cs#L19

// Specify the coloring mode for the pie series, pie measures and chart argument.
PieDashboardItem pie1 = (PieDashboardItem)dashboard.Items["pieDashboardItem1"];
ChartDashboardItem chart1 = (ChartDashboardItem)dashboard.Items["chartDashboardItem1"];

VB.NET

wpf-dashboard-viewer-item-tabs/VB/WpfDashboardTabSupportExample/WpfDashboardTabSupportExample/DashboardItemGenerator.vb#L33

Public Function GeneratePieItem(ByVal dataSource As IDashboardDataSource, ByVal itemComponentName As String) As DashboardItem
    Dim pieItem As PieDashboardItem = New PieDashboardItem() With {.ComponentName = itemComponentName}
    pieItem.DataSource = dataSource

winforms-dashboard-viewer-item-tabs/VB/TabSupportExample/DashboardItemGenerator.vb#L43

Public Shared Function GeneratePieItem(ByVal dataSource As IDashboardDataSource, ByVal itemComponentName As String) As DashboardItem
    Dim pieItem As New PieDashboardItem() With {.ComponentName = itemComponentName}
    pieItem.DataSource = dataSource

how-to-bind-a-pie-dashboard-item-to-data-in-code-e4769/VB/Dashboard_CreatePies/Form1.vb#L12

End Sub
Private Function CreatePies(ByVal dataSource As IDashboardDataSource) As PieDashboardItem
    Dim pies As New PieDashboardItem()

WinForms-Dashboard-How-to-export-customized-Pie-Dashboard-Item/VB/piesCustomExport/Form1.vb#L27

If e.ChartControl IsNot Nothing Then
    Dim pieItem As PieDashboardItem = TryCast(dashboardDesigner1.Dashboard.Items(e.DashboardItemName), PieDashboardItem)
    If pieItem Is Nothing Then

how-to-customize-a-dashboard-color-scheme-t184002/VB/Dashboard_Coloring/Form1.vb#L22

' Specify the coloring mode for the pie series, pie measures and chart argument.
Dim pie1 As PieDashboardItem = CType(dashboard.Items("pieDashboardItem1"), PieDashboardItem)
Dim chart1 As ChartDashboardItem = CType(dashboard.Items("chartDashboardItem1"), ChartDashboardItem)

Implements

ICustomPropertyProvider

Inheritance

Object

DashboardItem

DataDashboardItem

SeriesDashboardItem

ChartDashboardItemBase

PieDashboardItem