[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Expand]Charts Suite
  [Expand]Pivot Grid
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Collapse]Map Control
   [Expand]Getting Started
   [Expand]Coordinate Systems
   [Expand]Map Image Data
   [Expand]GIS Data
   [Collapse]Vector Data
    [Collapse]Providing Data
     [Expand]Add Vector Items Manually
     [Collapse]Load Vector Items from Vector Format Source
       Load Vector Data from a Shapefile
       Load Vector Data from a KML File
       Load Vector Data from a SQL Geometry Field of the Data Table
       Load Vector Data from a SVG File
      Generate Vector Items Automatically
      Generate Chart Items Automatically
      Provide Data Using Vector Item Attributes
   [Expand]Visual Elements
   [Expand]End-User Interaction
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Load Vector Data from a Shapefile

This document describes the basics of working with Shapefiles using the Map Control.

This subject consists of the following sections.

Expanded Overview

A Shapefile (Esri Shapefile) is a vector format that represents geographic data (e.g., rivers, lakes, and countries) using geometries (e.g., points, polylines, and polygons). Data in this format is usually stored in two files:

  • a .shp file that contains data about geometries;
  • a .dbf file that contains data associated with geometries from the corresponding .shp file.

To learn more about the Shapefile format, refer to Shapefile (Wikipedia).

The image below illustrates country shapes, along with supplemental information (country names in a tooltip) loaded from a Shapefile.

Expanded Load Shapefile Data

To load shapes from a Shapefile, do the following.

When data is loaded from a Shapefile, the Map control generates a collection of Vector Items objects stored in a VectorLayer.


Note that in this case, data from a .dbf file is stored as attributes in each vector item object. This approach allows you, for instance, to use this data to colorize shapes or display supplementary information in shape tooltips.

Expanded Examples

To learn how to load vector data from a shapefile, see the How to: Load Data from a Shapefile example.

Is this topic helpful?​​​​​​​