PieChartDataAdapter Class

The data adapter that provides data to generate Pie chart items.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v18.1.dll

Declaration

C#

[DataAccessMetadata("All", SupportedProcessingModes = "Simple", Platform = "Win", EnableDirectBinding = false)]
[PieChartDataAdapter.PieBindingProperties]
public class PieChartDataAdapter :
    ChartDataSourceAdapter

VB.NET

<PieChartDataAdapter.PieBindingProperties>
<DataAccessMetadata("All", SupportedProcessingModes:="Simple", Platform:="Win", EnableDirectBinding:=False)>
Public Class PieChartDataAdapter
    Inherits ChartDataSourceAdapter

Example

The PieChartDataAdapter class is intended to automatically generate pie charts from a data source.

To do this, create the PieChartDataAdapter object, set its DataSourceAdapterBase.DataSource property and assign this data adapter to the VectorItemsLayer.Data property.

Then, specify the following properties of the PieChartDataAdapter object.

• The PieChartDataAdapter.PieItemDataMember property;
• The MapItemMappingInfo.Latitude and MapItemMappingInfo.Longitude mappings of the PieChartDataAdapter.Mappings property;
• The MapChartItemMappingInfo.Value mapping of the PieChartDataAdapter.Mappings property;
• The MapPieMappingInfo.PieSegment mapping of the PieChartDataAdapter.Mappings property.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-use-piechartdataadapter-to-add-pie-charts-to-a-map-t141324

Form1.cs

    // Assign a PieChartDataAdapter object to Data.
    PieLayer.Data = CreateData();
// Create pie chart data adapter and specify its parameters.                
IMapDataAdapter CreateData() {
    PieChartDataAdapter adapter = new PieChartDataAdapter() {
        DataSource = LoadDataFromXml(xmlFilepath),
        PieItemDataMember = "Name",
        ItemMinSize = 20,
        ItemMaxSize = 60
    };

    // Specify mappings.
    adapter.Mappings.Latitude = "CapitalLat";
    adapter.Mappings.Longitude = "CapitalLon";
    adapter.Mappings.PieSegment = "MedalClass";
    adapter.Mappings.Value = "Quantity";

    // Specify measure rules
    adapter.MeasureRules = new MeasureRules();
    adapter.MeasureRules.RangeStops.Add(1);
    adapter.MeasureRules.RangeStops.Add(10);
    adapter.MeasureRules.RangeStops.Add(20);
    adapter.MeasureRules.RangeStops.Add(30);
    adapter.MeasureRules.RangeStops.Add(40);

    return adapter;
}

private DataTable LoadDataFromXml(string path) {
    DataSet ds = new DataSet();
    ds.ReadXml(path);
    DataTable table = ds.Tables[0];
    return table;
}

Form1.vb

    ' Assign a PieChartDataAdapter object to Data.
    PieLayer.Data = CreateData()
' Create pie chart data adapter and specify its parameters.                
Private Function CreateData() As IMapDataAdapter
    Dim adapter As New PieChartDataAdapter() With {.DataSource = LoadDataFromXml(xmlFilepath), .PieItemDataMember = "Name", .ItemMinSize = 20, .ItemMaxSize = 60}

    ' Specify mappings.
    adapter.Mappings.Latitude = "CapitalLat"
    adapter.Mappings.Longitude = "CapitalLon"
    adapter.Mappings.PieSegment = "MedalClass"
    adapter.Mappings.Value = "Quantity"

    ' Specify measure rules
    adapter.MeasureRules = New MeasureRules()
    adapter.MeasureRules.RangeStops.Add(1)
    adapter.MeasureRules.RangeStops.Add(10)
    adapter.MeasureRules.RangeStops.Add(20)
    adapter.MeasureRules.RangeStops.Add(30)
    adapter.MeasureRules.RangeStops.Add(40)

    Return adapter
End Function

Private Function LoadDataFromXml(ByVal path As String) As DataTable
    Dim ds As New DataSet()
    ds.ReadXml(path)
    Dim table As DataTable = ds.Tables(0)
    Return table
End Function

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the PieChartDataAdapter 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#

how-to-use-piechartdataadapter-to-add-pie-charts-to-a-map-t141324/CS/WinForms_MapControl_PieChartDataAdapter/Form1.cs#L29

IMapDataAdapter CreateData() {
    PieChartDataAdapter adapter = new PieChartDataAdapter() {
        DataSource = LoadDataFromXml(xmlFilepath),

VB.NET

how-to-use-piechartdataadapter-to-add-pie-charts-to-a-map-t141324/VB/WinForms_MapControl_PieChartDataAdapter/Form1.vb#L35

Private Function CreateData() As IMapDataAdapter
    Dim adapter As New PieChartDataAdapter() With {.DataSource = LoadDataFromXml(xmlFilepath), .PieItemDataMember = "Name", .ItemMinSize = 20, .ItemMaxSize = 60}

Implements

IMapDataAdapter

Inheritance

Object

MapDisposableObject

MapDataAdapterBase

CoordinateSystemDataAdapterBase

DataSourceAdapterBase

ChartDataSourceAdapter

PieChartDataAdapter