WmsDataProvider.ResponseCapabilities Event

Occurs when a Map control retrieves capabilities which the map service provides.

Namespace: DevExpress.Xpf.Map

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

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

Declaration

C#

public event CapabilitiesRespondedEventHandler ResponseCapabilities

VB.NET

Public Event ResponseCapabilities As CapabilitiesRespondedEventHandler

Event Data

The ResponseCapabilities event's data class is CapabilitiesRespondedEventArgs. The following properties provide information specific to this event:

Property	Description
Exception	Gets a thrown exception.
Layers	Returns a collection of available layers supported by a Web Map Service.

Example

This example demonstrates how to obtain a collection of layers supported by the Web Map Service.

To do this, use the WmsDataProvider.ResponseCapabilities event arguments to obtain the CapabilitiesRespondedEventArgs.Layers collection.

View Example

MainWindow.xaml

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:dxm="http://schemas.devexpress.com/winfx/2008/xaml/map"
    xmlns:Properties="clr-namespace:WpfWmsExample.Properties"
    x:Class="WpfWmsExample.MainWindow"
    Title="MainWindow" Height="360" Width="640">
    <Grid>
        <Grid.ColumnDefinitions>
            <ColumnDefinition Width="3*"/>
            <ColumnDefinition Width="*"/>
        </Grid.ColumnDefinitions>
        <dxm:MapControl Grid.Column="0"
            IsManipulationEnabled="False">
            <dxm:ImageLayer>
                <dxm:WmsDataProvider x:Name="Provider" 
                    ServerUri="http://Your_Server_URI" 
                    ActiveLayerName="{Binding ElementName=listBox, Path=SelectedItem.Name}"
                    ResponseCapabilities="OnResponseCapabilities"/>
            </dxm:ImageLayer>
        </dxm:MapControl>
        <StackPanel Grid.Column="1">
            <TextBlock Text="Available layers:"/>
            <ListBox x:Name="listBox"
                SelectedIndex="0"
                Background="AliceBlue" 
                DisplayMemberPath="Name" 
                Height="311"/>
        </StackPanel>
    </Grid>
</Window>

MainWindow.xaml.vb

Imports System.Windows
Imports DevExpress.Xpf.Map

Namespace WpfWmsExample
    ''' <summary>
    ''' Interaction logic for MainWindow.xaml
    ''' </summary>
    Partial Public Class MainWindow
        Inherits Window

        Public Sub New()
            InitializeComponent()
        End Sub
        Private Sub OnResponseCapabilities(ByVal sender As Object, ByVal e As CapabilitiesRespondedEventArgs)
            listBox.ItemsSource = e.Layers
        End Sub
    End Class
End Namespace

MainWindow.xaml.cs

using System.Windows;
using DevExpress.Xpf.Map;

namespace WpfWmsExample {
    /// <summary>
    /// Interaction logic for MainWindow.xaml
    /// </summary>
    public partial class MainWindow : Window {
        public MainWindow() {
            InitializeComponent();
        }
        private void OnResponseCapabilities(object sender, CapabilitiesRespondedEventArgs e) {
            listBox.ItemsSource = e.Layers;
        }
    }
}

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ResponseCapabilities event.

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-obtain-an-available-wms-layer-collection-t365161/CS/WpfWmsExample/MainWindow.xaml#L19

        ActiveLayerName="{Binding ElementName=listBox, Path=SelectedItem.Name}"
        ResponseCapabilities="OnResponseCapabilities"/>
</dxm:ImageLayer>