TreeMapControl.DataAdapter Property

Gets or sets the data adapter for a TreeMap control.

Namespace: DevExpress.XtraTreeMap

Assembly: DevExpress.XtraTreeMap.v20.2.UI.dll

NuGet Package: DevExpress.Win.TreeMap

Declaration

C#

public ITreeMapDataAdapter DataAdapter { get; set; }

VB.NET

Public Property DataAdapter As ITreeMapDataAdapter

Property Value

Type	Description
ITreeMapDataAdapter	An object of a class implementing the ITreeMapDataAdapter interface.

Example

To provide flat data to a TreeMap, create a TreeMapFlatDataAdapter object and assign it to the TreeMapControl.DataAdapter property. Then, specify the adapter’s TreeMapFlatDataAdapter.DataSource, TreeMapFlatDataAdapter.LabelDataMember and TreeMapFlatDataAdapter.ValueDataMember to configure the data source object and which data members should be used to generate tree map items. If you need to group generated items, add the name of a data member whose values should be used to group items, to the TreeMapFlatDataAdapter.GroupDataMembers collection.

View Example

Form1.cs

void ConfigureTreeMapDataAdapter() {
    TreeMapFlatDataAdapter adapter = new TreeMapFlatDataAdapter {
        DataSource = CreateBillionaireInfos(),
        LabelDataMember = "Name",
        ValueDataMember = "NetWorth"
    };
    adapter.GroupDataMembers.Add("Residence");
    treeMap.DataAdapter = adapter;
}

Form1.vb

Private Sub ConfigureTreeMapDataAdapter()
    Dim adapter As TreeMapFlatDataAdapter = New TreeMapFlatDataAdapter With {.DataSource = CreateBillionaireInfos(), .LabelDataMember = "Name", .ValueDataMember = "NetWorth"}
    adapter.GroupDataMembers.Add("Residence")
    treeMap.DataAdapter = adapter
End Sub

Related GitHub Examples

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

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-implement-a-custom-colorizer-t361751/CS/CustomColorizerSample/Form1.cs#L24

    adapter.GroupDataMembers.Add("Residence");
    treeMap.DataAdapter = adapter;
}

how-to-color-treemap-items-using-range-colorizer-t361287/CS/RangeColorizerSample/Form1.cs#L36

    treeMap.DataAdapter = dataAdapter;
}

how-to-provide-hierarchical-data-to-treemap-t360961/CS/HierarchicalDataAdapterSample/Form1.cs#L37

    treeMap.DataAdapter = dataAdapter;
}

winforms-treemap-load-flat-data/CS/FlatDataAdapterSample/Form1.cs#L26

    adapter.GroupDataMembers.Add("Residence");
    treeMap.DataAdapter = adapter;
}

how-to-manually-populate-treemap-with-data-t360867/CS/ItemStorageSample/Form1.cs#L20

TreeMapItemStorage storage = new TreeMapItemStorage();
treeMap.DataAdapter = storage;

VB.NET

how-to-implement-a-custom-colorizer-t361751/VB/CustomColorizerSample/Form1.vb#L22

    adapter.GroupDataMembers.Add("Residence")
    treeMap.DataAdapter = adapter
End Sub

how-to-color-treemap-items-using-range-colorizer-t361287/VB/RangeColorizerSample/Form1.vb#L30

    treeMap.DataAdapter = dataAdapter
End Sub

how-to-provide-hierarchical-data-to-treemap-t360961/VB/HierarchicalDataAdapterSample/Form1.vb#L31

    treeMap.DataAdapter = dataAdapter
End Sub

winforms-treemap-load-flat-data/VB/FlatDataAdapterSample/Form1.vb#L25

    adapter.GroupDataMembers.Add("Residence")
    treeMap.DataAdapter = adapter
End Sub

how-to-manually-populate-treemap-with-data-t360867/VB/ItemStorageSample/Form1.vb#L22

Dim storage As New TreeMapItemStorage()
treeMap.DataAdapter = storage