ListSourceDataAdapter Class

A data adapter that loads data from list sources and displays it on vector layers.

Assembly: DevExpress.Xpf.Map.v20.2.dll

NuGet Packages: DevExpress.WindowsDesktop.Wpf.Map, DevExpress.Wpf.Map

Declaration

C#
VB.NET

[ListSourceCustomBindingProperties]
public class ListSourceDataAdapter :
    DataSourceAdapterBase

<ListSourceCustomBindingProperties>
Public Class ListSourceDataAdapter
    Inherits DataSourceAdapterBase

Remarks

ListSourceDataAdapter handles notifications from objects that inherit the INotifyCollectionChanged and INotifyPropertyChanged interfaces. Since the BindableBase class implements the INotifyPropertyChanged interface, you can implement your Model class as a descendant of the BindableBase class to apply data source changes to the Map Control automatically:

C#
VB.NET

public class MyModel: BindableBase {
  public string Name { get; set; }

  public double Latitude {
      get { return GetValue<double>(nameof(Latitude)); }
      set { SetValue(value, nameof(Latitude)); }
  }

  public double Longitude {
      get { return GetValue<double>(nameof(Longitude)); }
      set { SetValue(value, nameof(Longitude)); }
  }
}

Public Class MyModel
    Inherits BindableBase

    Public Property Name As String

    Public Property Latitude As Double
        Get
            Return GetValue(Of Double)(NameOf(MyModel.Latitude))
        End Get
        Set(ByVal value As Double)
            SetValue(value, NameOf(MyModel.Latitude))
        End Set
    End Property

    Public Property Longitude As Double
        Get
            Return GetValue(Of Double)(NameOf(MyModel.Longitude))
        End Get
        Set(ByVal value As Double)
            SetValue(value, NameOf(MyModel.Longitude))
        End Set
    End Property
End Class

Example

Follow the steps below to use the ListSourceDataAdapter:

Create a ListSourceDataAdapter object and assign it to the VectorLayer.Data property.
Specify the DataSourceAdapterBase.DataSource property.
Configure the ListSourceDataAdapter.Mappings property to assign data source field values to map items.
Use the ListSourceDataAdapter.ItemSettings property to specify map item settings.

View Example

MainWindow.xaml

<dxm:VectorLayer.Data>
    <dxm:ListSourceDataAdapter DataSource="{Binding Source={StaticResource data}, XPath=Ship}">
        <dxm:ListSourceDataAdapter.AttributeMappings>
            <dxm:MapItemAttributeMapping Name="Name" Member="Name"/>
            <dxm:MapItemAttributeMapping Name="Year" Member="Year"/>
            <dxm:MapItemAttributeMapping Name="Description" Member="Description"/>
        </dxm:ListSourceDataAdapter.AttributeMappings>
        <dxm:ListSourceDataAdapter.Mappings>
            <dxm:MapItemMappingInfo Latitude="Latitude" Longitude="Longitude"/>
        </dxm:ListSourceDataAdapter.Mappings>
        <dxm:ListSourceDataAdapter.ItemSettings>
            <dxm:MapCustomElementSettings ContentTemplate="{Binding Source={StaticResource itemTemplate}}"/>
        </dxm:ListSourceDataAdapter.ItemSettings>
    </dxm:ListSourceDataAdapter>
</dxm:VectorLayer.Data>

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

XAML

how-to-implement-a-custom-clusterer-t311800/CS/CustomClustererSample/MainWindow.xaml#L18

<dxm:VectorLayer DataLoaded="VectorLayer_DataLoaded">
    <dxm:ListSourceDataAdapter DataSource="{Binding Source={StaticResource dataSource}}"
                               DataMember="Row">