DataSourceAdapterBase.DataSource Property

Specifies the data source to provide data for a data adapter.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v18.2.dll

Declaration

C#

[DefaultValue(null)]
public object DataSource { get; set; }

VB.NET

<DefaultValue(Nothing)>
Public Property DataSource As Object

Property Value

Type	Default	Description
Object	*null*	A Object.

Example

This example demonstrates how to generate bubble charts for a map control. Do the following:

• Create a VectorItemsLayer object and add it to the map control.
• Create a BubbleChartDataAdapter object and assign it to the VectorItemsLayer.Data property.
• Generate a data source with data for bubble charts and assign it to the DataSourceAdapterBase.DataSource property.
• Specify the mappings for bubble chart properties to corresponding columns in a datasource (a MapBubbleMappingInfo object that can be accessed using the BubbleChartDataAdapter.Mappings property).
• Specify the attribute mappings that are used to provide additional information about the map item to a map control.(an MapItemAttributeCollection object that can be accessed using the BubbleChartDataAdapter.Mappings property).

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-display-bubble-chart-items-on-a-map-t113410

Form1.cs

    // Specify data for the bubble layer.
    BubbleLayer.Data = CreateData();
private IMapDataAdapter CreateData() {
    BubbleChartDataAdapter adapter = new BubbleChartDataAdapter() {
        DataSource = LoadData(),
        MeasureRules = CreateMeasureRules(),
        ItemMaxSize = 60,
        ItemMinSize = 10
    };

    #region #Mappings
    // Map the properties of chart items to the appropriate fields in the data source.
    adapter.Mappings.Latitude = "glat";
    adapter.Mappings.Longitude = "glon";
    adapter.Mappings.Value = "mag";
    #endregion #Mappings

    // Create attribute mappings to provide additional information about map items to the map.
    adapter.AttributeMappings.Add(new MapItemAttributeMapping("Magnitude", "mag"));
    adapter.AttributeMappings.Add(new MapItemAttributeMapping("Year", "yr"));
    adapter.AttributeMappings.Add(new MapItemAttributeMapping("Month", "mon"));
    adapter.AttributeMappings.Add(new MapItemAttributeMapping("Day", "day"));
    adapter.AttributeMappings.Add(new MapItemAttributeMapping("Depth", "dep"));

    return adapter;
}

private DataTable LoadData() {
    DataSet ds = new DataSet();
    ds.ReadXml(dataPath);
    DataTable dt = ds.Tables[0];
    dt.DefaultView.RowFilter = string.Format(CultureInfo.InvariantCulture, "(mag >= {0}) AND (mag <= {1})", minMagnitude, maxMagnitude);

    return ds.Tables[0];
}

private MeasureRules CreateMeasureRules() {
    MeasureRules measureRules = new MeasureRules();

    measureRules.ApproximateValues = true;
    measureRules.RangeDistribution = new LinearRangeDistribution();

    for (int i = minMagnitude; i < maxMagnitude; i++) {
        measureRules.RangeStops.Add(i);
    }

    return measureRules;
}

Form1.vb

    ' Specify data for the bubble layer.
    BubbleLayer.Data = CreateData()
Private Function CreateData() As IMapDataAdapter
    Dim adapter As New BubbleChartDataAdapter() With {.DataSource = LoadData(), .MeasureRules = CreateMeasureRules(), .ItemMaxSize = 60, .ItemMinSize = 10}

    '            #Region "#Mappings"
    ' Map the properties of chart items to the appropriate fields in the data source.
    adapter.Mappings.Latitude = "glat"
    adapter.Mappings.Longitude = "glon"
    adapter.Mappings.Value = "mag"

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DataSource 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#

winforms-map-bind-to-xml-data/CS/WinForms_MapControl_ListAdapter/Form1.cs#L52

adapter.DataSource = source;

how-to-customize-drawing-of-vector-items-on-a-map-t120297/CS/Form1.cs#L14

    ListSourceDataAdapter adapter = (ListSourceDataAdapter)Layer.Data;
    adapter.DataSource = TestData.Instance;
}

winforms-map-aggregate-vector-items-using-a-clusterer/CS/ClustererSample/Form1.cs#L19

private void Form1_Load(object sender, EventArgs e) {
    DataAdapter.DataSource = LoadData();
    DistanceBasedClusterer clusterer = new DistanceBasedClusterer {

how-to-implement-a-custom-clusterer-t312237/CS/CustomClustererSample/Form1.cs#L20

DataAdapter.DataSource = LoadData();
DataAdapter.Clusterer = new CureClusterer();

how-to-provide-additional-property-values-from-a-data-source-using-property-mappings-t289947/CS/PropertyMappingsSample/Form1.cs#L37

var dataAdapter = new ListSourceDataAdapter();
dataAdapter.DataSource = dataSource;
dataAdapter.DefaultMapItemType = MapItemType.Rectangle;

VB.NET

winforms-map-bind-to-xml-data/VB/WinForms_MapControl_ListAdapter/Form1.vb#L39

Dim adapter As ListSourceDataAdapter = New ListSourceDataAdapter()
adapter.DataSource = source
adapter.Mappings.Latitude = "Latitude"

how-to-customize-drawing-of-vector-items-on-a-map-t120297/VB/Form1.vb#L16

    Dim adapter As ListSourceDataAdapter = CType(Layer.Data, ListSourceDataAdapter)
    adapter.DataSource = TestData.Instance
End Sub

winforms-map-aggregate-vector-items-using-a-clusterer/VB/ClustererSample/Form1.vb#L29

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
    DataAdapter.DataSource = LoadData()
    Dim clusterer As DistanceBasedClusterer = New DistanceBasedClusterer With {

how-to-customize-mini-map-layers-t201418/VB/MiniMapLayers/Form1.vb#L78

Dim adapter As New ListSourceDataAdapter()
adapter.DataSource = data
adapter.Mappings.Latitude = "Latitude"

how-to-implement-a-custom-clusterer-t312237/VB/CustomClustererSample/Form1.vb#L32

DataAdapter.DataSource = LoadData()
DataAdapter.Clusterer = New CureClusterer()