Back to Devexpress

SunburstHierarchicalDataAdapter.DataSource Property

windowsforms-devexpress-dot-xtratreemap-dot-sunbursthierarchicaldataadapter-426f1d2d.md

latest4.6 KB
Original Source

SunburstHierarchicalDataAdapter.DataSource Property

Gets or sets the object that is the data adapter’s data source.

Namespace : DevExpress.XtraTreeMap

Assembly : DevExpress.XtraTreeMap.v25.2.dll

NuGet Package : DevExpress.TreeMap

Declaration

csharp
[DefaultValue(null)]
[XtraSerializableProperty(XtraSerializationVisibility.Hidden)]
public object DataSource { get; set; }
vb
<DefaultValue(Nothing)>
<XtraSerializableProperty(XtraSerializationVisibility.Hidden)>
Public Property DataSource As Object

Property Value

TypeDefaultDescription
Objectnull

A Object that is the data source.

|

Example

This example demonstrates how to visualize hierarchical data using the SunburstControl.

Create a SunburstHierarchicalDataAdapter object and assign it to the SunburstControl.DataAdapter property to provide hierarchical data to a Sunburst. Then, specify the adapter’s data source object using the SunburstHierarchicalDataAdapter.DataSource property. Populate the SunburstHierarchicalDataAdapter.Mappings collection with SunburstHierarchicalDataMapping objects to configure how the SunburstControl should convert hierarchical data to sunburst items. The HierarchicalDataMapping.LabelDataMember property allows you to specify a label data member, the HierarchicalDataMapping.ValueDataMember property - a value data member, the HierarchicalDataMapping.ChildrenDataMember property - a data member that contains children items and the HierarchicalDataMapping.Type property - types of items at the current level.

csharp
private void OnFormLoad(object sender, EventArgs e) {
    SunburstHierarchicalDataAdapter dataAdapter = new SunburstHierarchicalDataAdapter();
    dataAdapter.Mappings.Add(new SunburstHierarchicalDataMapping {
        Type = typeof(CountryInfo), 
        LabelDataMember = "CountryName",  
        ChildrenDataMember = "CityInfos"
    });
    dataAdapter.Mappings.Add(new SunburstHierarchicalDataMapping {
        Type = typeof(CityInfo),  
        LabelDataMember = "CityName",              
        ChildrenDataMember = "SaleInfos"
    });
    dataAdapter.Mappings.Add(new SunburstHierarchicalDataMapping {
        Type = typeof(ProductInfo),
        ValueDataMember = "Total",
        LabelDataMember = "Category",
    });
    dataAdapter.DataSource = CreateInfos();
    sunburstControl.DataAdapter = dataAdapter;
}
vb
Private Sub OnFormLoad(ByVal sender As Object, ByVal e As EventArgs)
    Dim dataAdapter As SunburstHierarchicalDataAdapter = New SunburstHierarchicalDataAdapter()
    dataAdapter.Mappings.Add(New SunburstHierarchicalDataMapping With {
        .Type = GetType(CountryInfo),
        .LabelDataMember = "CountryName",
        .ChildrenDataMember = "CityInfos"
    })
    dataAdapter.Mappings.Add(New SunburstHierarchicalDataMapping With {
        .Type = GetType(CityInfo),
        .LabelDataMember = "CityName",
        .ChildrenDataMember = "SaleInfos"
    })
    dataAdapter.Mappings.Add(New SunburstHierarchicalDataMapping With {
        .Type = GetType(ProductInfo),
        .ValueDataMember = "Total",
        .LabelDataMember = "Category"
    })
    dataAdapter.DataSource = CreateInfos()
    sunburstControl.DataAdapter = dataAdapter
End Sub

See Also

SunburstHierarchicalDataAdapter Class

SunburstHierarchicalDataAdapter Members

DevExpress.XtraTreeMap Namespace