Load Secure WebMap

This sample demonstrates adding data in a secure WebMap document housed via ArcGIS Online (http://www.arcgis.com) in a WPF application. The user inputs a web map, along with their user name and password, to authorize access to the web map. The input is made into a URL used to generate a token from ArcGIS.com, and once a token is returned it is added to the WebMap request using the WebMap.Token property. Then the WebMap.GetMapAsync method call takes a Globally Unique Identifier (GUID) for the WebMap service provided by ArcGIS Online to obtain the geographic data layers. The WebMap’s GetMapCompletedEventArgs.Map Property is used to add a Map Class to the WPF application for visual display.

XAML

<UserControl x:Class="ArcGISWPFSDK.LoadSecureWebMap"
            xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
    xmlns:esri="http://schemas.esri.com/arcgis/client/2009">
    <Grid x:Name="LayoutRoot" >
        <Grid.Resources>
            <LinearGradientBrush x:Key="PanelGradient" EndPoint="0.5,1" StartPoint="0.5,0">
                <LinearGradientBrush.RelativeTransform>
                    <TransformGroup>
                        <ScaleTransform CenterY="0.5" CenterX="0.5"/>
                        <SkewTransform CenterY="0.5" CenterX="0.5"/>
                        <RotateTransform Angle="176" CenterY="0.5" CenterX="0.5"/>
                        <TranslateTransform/>
                    </TransformGroup>
                </LinearGradientBrush.RelativeTransform>
                <GradientStop Color="#FF145787" Offset="0.16"/>
                <GradientStop Color="#FF3D7FAC" Offset="0.502"/>
                <GradientStop Color="#FF88C5EF" Offset="0.984"/>
            </LinearGradientBrush>
        </Grid.Resources>
        <Grid HorizontalAlignment="Right" VerticalAlignment="Top" Margin="0,15,15,0">
            <Rectangle Stroke="Gray"  RadiusX="10" RadiusY="10" Fill="{StaticResource PanelGradient}" Margin="0,0,0,5" >
                <Rectangle.Effect>
                    <DropShadowEffect/>
                </Rectangle.Effect>
            </Rectangle>
            <Rectangle Fill="#DDFFFFFF" Stroke="DarkGray" RadiusX="5" RadiusY="5" Margin="10" />
            <StackPanel Orientation="Vertical" HorizontalAlignment="Center" Margin="20,20,20,20">
                <TextBlock FontWeight="Bold" HorizontalAlignment="Center" Text="Enter ArcGIS.com WebMap ID, Username, Password" Foreground="Black" />
                <Grid>
                    <Grid.ColumnDefinitions>
                        <ColumnDefinition Width="*"/>
                        <ColumnDefinition Width="*"/>
                    </Grid.ColumnDefinitions>
                    <Grid.RowDefinitions>
                        <RowDefinition Height="*" />
                        <RowDefinition Height="*" />
                        <RowDefinition Height="*" />
                    </Grid.RowDefinitions>
                    <TextBlock Text="WebMap ID: " TextAlignment="Right" Grid.Column="0" Grid.Row="0"
                               VerticalAlignment="Center" HorizontalAlignment="Left" Foreground="Black"/>
                    <TextBox x:Name="WebMapTextBox" Width="250" Grid.Column="1" Grid.Row="0" HorizontalAlignment="Right" Margin="0,2,0,2" Foreground="Black"/>
                    <TextBlock Text="Username: " TextAlignment="Right" HorizontalAlignment="Left" Grid.Column="0" Grid.Row="1"
                               VerticalAlignment="Center" Foreground="Black" />
                    <TextBox x:Name="UsernameTextBox" Width="250" Grid.Column="1" Grid.Row="1" Margin="0,2,0,2" Foreground="Black"/>
                    <TextBlock Text="Password: " TextAlignment="Right" HorizontalAlignment="Left" 
                               VerticalAlignment="Center" Grid.Column="0" Grid.Row="2" Foreground="Black"/>
                    <PasswordBox x:Name="PasswordTextBox" Width="250" HorizontalAlignment="Right" Grid.Column="1" Grid.Row="2" Margin="0,2,0,2" Foreground="Black"/>
                </Grid>
                <Button x:Name="LoadWebMapButton" Content="Load WebMap" Width="100" Margin="0,5,0,10" 
                        HorizontalAlignment="Center" Click="LoadWebMapButton_Click" Foreground="Black"/>
            </StackPanel>
        </Grid>
    </Grid>
</UserControl>

C#

using System.Windows.Controls;
using System;
using System.Windows;
using ESRI.ArcGIS.Client.WebMap;
using ESRI.ArcGIS.Client;

namespace ArcGISWPFSDK
{
    /// <summary>
    /// Interaction logic for LoadSecureWebMap.xaml
    /// </summary>
    public partial class LoadSecureWebMap : UserControl
    {
        public LoadSecureWebMap()
        {
            InitializeComponent();
            
            // Wire up the method that will handle the Challenge for credentials.
            IdentityManager.Current.ChallengeMethod = Challenge;
        }

        private void Challenge(string url, System.Action<IdentityManager.Credential, Exception> callback, IdentityManager.GenerateTokenOptions options)
        {
            // When challenged for a token generate a set of credentials based on the specified username and password.
            IdentityManager.Current.GenerateCredentialAsync(url, UsernameTextBox.Text, PasswordTextBox.Password, (credential, ex) =>
            {
                // Raise the Action to return to the method that triggered the challenge (GetMapAsync).
                callback(credential, ex);
            }, options);
        }

        private void LoadWebMapButton_Click(object sender, System.Windows.RoutedEventArgs e)
        {
            // Create a new WebMap Document
            Document document = new Document();

            // Handle the GetMapCompleted event.
            document.GetMapCompleted += (s, getMapCompletedEventArgs) =>
            {
                // Check the Error property of the GetMapCompletedEventArgs for a connection or login failure.
                if(getMapCompletedEventArgs.Error != null)
                {
                    // Show the error and exit. 
                    MessageBox.Show(getMapCompletedEventArgs.Error.Message,"Error",MessageBoxButton.OK,MessageBoxImage.Information);
                    return;
                }

                // Insert the map into the window.
                LayoutRoot.Children.Insert(0, getMapCompletedEventArgs.Map);
            };
            // Call the GetMayAsync method to retrieve the WebMap by ArcGIS.com item identifier.
            document.GetMapAsync(WebMapTextBox.Text, null);
        }
    }
}

VB.NET

Imports System.Windows.Controls
Imports ESRI.ArcGIS.Client.WebMap
Imports System.Net
Imports System.IO
Imports System.Collections.Generic
Imports System.Windows
Imports ESRI.ArcGIS.Client

Namespace ArcGISWPFSDK
    Partial Public Class LoadSecureWebMap
        Inherits UserControl

        Public Sub New()
            InitializeComponent()

            ' Activate identity manager
            IdentityManager.Current.ChallengeMethod = AddressOf Challenge

        End Sub

        Private Sub Challenge(ByVal url As String, ByVal callback As Action(Of IdentityManager.Credential, Exception), ByVal options As IdentityManager.GenerateTokenOptions)

            IdentityManager.Current.GenerateCredentialAsync _
                (url, UsernameTextBox.Text, PasswordTextBox.Password,
                 Sub(credential, ex)
                     callback(credential, ex)
                 End Sub _
                 , options)
        End Sub

        Private Sub LoadWebMapButton_Click(sender As Object, e As System.Windows.RoutedEventArgs)

            ' Create a new WebMap Document
            Dim document As New Document()

            AddHandler document.GetMapCompleted, AddressOf webMap_GetMapCompleted
            ' Call the GetMayAsync method to retrieve the WebMap by ArcGIS.com item identifier.
            document.GetMapAsync(WebMapTextBox.Text)

        End Sub

        Private Sub webMap_GetMapCompleted(sender As Object, e As GetMapCompletedEventArgs)

            ' Handle the GetMapCompleted event.
            ' Check the Error property of the GetMapCompletedEventArgs for a connection or login failure.
            If e.[Error] IsNot Nothing Then
                ' Show the error and exit. 
                MessageBox.Show(e.[Error].Message, "Error", MessageBoxButton.OK, MessageBoxImage.Information)
                Return
            Else
                ' Insert the map into the window.
                LayoutRoot.Children.Insert(0, e.Map)
            End If

        End Sub
    End Class
End Namespace