ShapefileDataAdapter Class

Data adapter that provides data from a shapefile.

Namespace: DevExpress.XtraMap

Assembly: DevExpress.XtraMap.v18.1.dll

Declaration

C#

public class ShapefileDataAdapter :
    FileDataAdapterBase,
    ISupportBoundingRectAdapter

VB.NET

Public Class ShapefileDataAdapter
    Inherits FileDataAdapterBase
    Implements ISupportBoundingRectAdapter

Remarks

Currently, the following shapefile element types are supported.

• Point
• PolyLine
• Polygon
• Multipoint
• PointZ (the Z value is ignored)
• PolylineZ (the Z value is ignored)
• PolygonZ (the Z value is ignored)
• MultipointZ (the Z value is ignored)
• PointM (the M value is ignored)
• PolylineM (the M value is ignored)
• PolygonM (the M value is ignored)
• MultipointM (the M value is ignored)

For more information about Shapefile element types, refer to the ERSI Shapefile Technical Description

For more information about this data adapter, refer to the Load Vector Data from a Shapefile topic.

Example

To load shape data from a shapefile do the following.

• Create a ShapefileDataAdapter object.
• Specify its ShapefileDataAdapter.FileUri property.
• Assign this object as the VectorItemsLayer.Data property value.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-colorize-map-contours-loaded-from-shapefiles-using-the-choropleth-colorizer-e4691

Form1.cs

    // Create data for the MapLayer.
    MapLayer.Data = CreateData();
private MapDataAdapterBase CreateData() {
    Uri baseUri = new Uri(System.Reflection.Assembly.GetEntryAssembly().Location);

    // Create an adapter to load data from shapefile.
    ShapefileDataAdapter adapter = new ShapefileDataAdapter() {
        FileUri = new Uri(baseUri, filename)
    };

    return adapter;
}

Form1.vb

    ' Create data for the MapLayer.
    MapLayer.Data = CreateData()
Private Function CreateData() As MapDataAdapterBase
    Dim baseUri As New Uri(System.Reflection.Assembly.GetEntryAssembly().Location)

    ' Create an adapter to load data from shapefile.
    Dim adapter As New ShapefileDataAdapter() With {.FileUri = New Uri(baseUri, filename)}

    Return adapter
End Function

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ShapefileDataAdapter 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-customize-coordinate-systems-of-a-map-and-data-source-t202055/CS/CoordinateSystems/Form1.cs#L12

ShapefileDataAdapter Adapter { get; set; }

how-to-implement-a-custom-map-projection-e4783/CS/CustomProjection/Form1.cs#L17

ShapefileDataAdapter Adapter {
    get { return (ShapefileDataAdapter)MapLayer.Data; }

how-to-automatically-load-a-cartesian-data-shapefile-onto-a-geo-map-t208696/CS/LoadGeoShapeData/Form1.cs#L10

List<MapData> data = new List<MapData>();
ShapefileDataAdapter adapter = new ShapefileDataAdapter();

vote-app-t445500/CS/VoteApp/Map.cs#L344

List<MapItem> mapItems = new List<MapItem>();
ShapefileDataAdapter shapeAdapter = new ShapefileDataAdapter();
shapeAdapter.ItemsLoaded += (s, e) => { mapItems.AddRange(e.Items); };

vote-applications-t446758/CS/VoteApp/Map.cs#L343

List<MapItem> mapItems = new List<MapItem>();
ShapefileDataAdapter shapeAdapter = new ShapefileDataAdapter();
shapeAdapter.ItemsLoaded += (s, e) => { mapItems.AddRange(e.Items); };

VB.NET

how-to-customize-coordinate-systems-of-a-map-and-data-source-t202055/VB/CoordinateSystems/Form1.vb#L14

Private Property Adapter() As ShapefileDataAdapter

how-to-configure-a-range-distribution-of-choroplethcolorizer-t142434/VB/RangeDistributions/Form1.vb#L29

End Property
Private ReadOnly Property Adapter() As ShapefileDataAdapter
    Get

how-to-implement-a-custom-map-projection-e4783/VB/CustomProjection/Form1.vb#L23

Private ReadOnly Property Adapter() As ShapefileDataAdapter
    Get

how-to-automatically-load-a-cartesian-data-shapefile-onto-a-geo-map-t208696/VB/LoadGeoShapeData/Form1.vb#L12

Private data As New List(Of MapData)()
Private adapter As New ShapefileDataAdapter()

how-to-colorize-map-contours-loaded-from-shapefiles-using-the-graph-colorizer-e4723/VB/MapGraphColorizer/Form1.vb#L34

' Create an object to load data from a shapefile.
Dim loader As New ShapefileDataAdapter()

Implements

IMapDataAdapter

Inheritance

Object

MapDisposableObject

MapDataAdapterBase

CoordinateSystemDataAdapterBase

DevExpress.XtraMap.OuterDataAdapterBase

FileDataAdapterBase

ShapefileDataAdapter