How to: Add a Map Control at Runtime

• Jun 19, 2025
• 2 minutes to read

This example demonstrates how to add a MapControl to a WPF application and connect the map to the AzureMapDataProvider at runtime.

1. Run Microsoft Visual Studio.

2. Create a new WPF Application project or open an existing one.

3. Open the Solution Explorer, right-click References and choose Add Reference….

   Add references to the following assemblies in the Extensions tab:

   • DevExpress.Xpf.Map.v25.1
   • DevExpress.Map.v25.1.Core
   • DevExpress.Data.v25.1

   

   Click OK.

4. Handle the Window’s Loaded event as follows:

   C#

   using System.Windows;
   using DevExpress.Xpf.Map;
   
   
   namespace DXMap_Runtime {
       public partial class MainWindow : Window {
           public MainWindow() {
               InitializeComponent();
           }
   
           private void Window_Loaded(object sender, RoutedEventArgs e) {
               // Create a map control and add it to the window.
               MapControl map = new MapControl();
               this.Content = map;
   
               // Create a layer.
               ImageLayer layer = new ImageLayer() {
                   DataProvider = new AzureMapDataProvider() {
                       AzureKey = "Insert your Azure Maps key here.",
                       Tileset = AzureTileset.BaseRoad
                   }
               };
               map.Layers.Add(layer);
               map.ZoomLevel = 4;
               map.CenterPoint = new GeoPoint(40, -100);
           }
       }
   }
   

   VB.NET

   Imports System.Windows
   Imports DevExpress.Xpf.Map
   
   Namespace DXMap_Runtime
   
       Partial Public Class MainWindow
           Inherits Window
   
           Public Sub New()
               InitializeComponent()
           End Sub
   
           Private Sub Window_Loaded(ByVal sender As Object, ByVal e As RoutedEventArgs)
               ' Create a map control and add it to the window.
               Dim map As New MapControl()
               Me.Content = map
   
               ' Create a layer.
               Dim layer As New ImageLayer() With {
                   .DataProvider = New AzureMapDataProvider() With {
                       .AzureKey = "Insert your Azure Maps key here.",
                       .Tileset = AzureTileset.BaseRoad
                   }
               }
               map.Layers.Add(layer)
               map.ZoomLevel = 4
               map.CenterPoint = New GeoPoint(40, -100)
           End Sub
   
       End Class
   End Namespace
   

5. Run the project to see the result.