[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [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 SVG File
       Load Vector Data from a SQL Geometry Field of the Data Table
      Generate Vector Items Automatically
      Generate Chart Items Automatically
      Provide Data Using Vector Item Attributes
   [Expand]Visual Elements
   [Expand]End-User Features
   [Expand]Product Information
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[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 above country shapes) 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 item objects stored in a VectorItemsLayer.


All data stored in a .dbf will be provided as attribute values for each vector item. This approach allows you, for instance, to use this data to colorize shapes or to display supplementary information in shape tooltips.

Expanded Examples

To learn how this can be done, see the How to: Load Data from a Shapefile example.

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