Dynamic Layers Thematic Mapping Online

This sample demonstrates the ability to define and apply thematic rendering properties on a layer within an ArcGIS Server dynamic map service via DynamicLayer using the GenerateRenderer Task. To use the sample enter the appropriate parameters and click on Apply to change the renderer.

XAML

<UserControl x:Class="ArcGISWPFSDK.DynamicLayersThematic"
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" Background="White">
        <Grid.Resources>
            <BooleanToVisibilityConverter x:Key="BooleanToVisibilityConverter"/>
            <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>
        <esri:Map x:Name="MyMap" WrapAround="True" Extent="-15000000,2000000,-7000000,8000000">
            <esri:ArcGISTiledMapServiceLayer ID="BaseMapLayer" 
                    Url="http://services.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer" />
            <esri:FeatureLayer ID="StatesFeatureLayer" OutFields="*" DisplayName="USA Census - States"
                    Url="http://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer/dynamicLayer" 
                               Initialized="FeatureLayer_Initialized">
                <esri:FeatureLayer.Source>
                    <esri:LayerMapSource MapLayerID="3"/>
                </esri:FeatureLayer.Source>
            </esri:FeatureLayer>
        </esri:Map>
        <esri:Legend Map="{Binding ElementName=MyMap}" VerticalAlignment="Top" HorizontalAlignment="Left" Margin="10,10,10,10" Padding="5"
                         LayerIDs="StatesFeatureLayer"
                         LayerItemsMode="Tree"
                         BorderBrush="{StaticResource PanelGradient}" BorderThickness="5" Background="#DDFFFFFF" 
                         >
            <esri:Legend.Effect>
                <DropShadowEffect />
            </esri:Legend.Effect>
        </esri:Legend>
        <StackPanel Orientation="Vertical" Margin="10" HorizontalAlignment="Right" VerticalAlignment="Top">
            <Grid x:Name="DynamicLayersUiGrid">
                <Rectangle Fill="{StaticResource PanelGradient}" Stroke="Gray" Margin="0,0,0,5">
                    <Rectangle.Effect>
                        <DropShadowEffect/>
                    </Rectangle.Effect>
                </Rectangle>
                <StackPanel Orientation="Vertical" VerticalAlignment="Top">
                    <Canvas Margin="5,5,5,5" Height="520"  Width="160" >
                        <Rectangle Height="515" Width="160" RadiusX="5" RadiusY="5" Fill="#DDFFFFFF" Stroke="DarkGray"/>
                        <Grid x:Name="ClassGrid" Grid.Column="1" Margin="2">            
            <Grid.RowDefinitions>
                <RowDefinition Height="30" />
                <RowDefinition Height="*" />
                <RowDefinition Height="40" />
            </Grid.RowDefinitions>
            <TextBlock TextAlignment="Center" Text="Set Thematic Properties" 
                      FontWeight="Bold" Height="16" Grid.Row="0" />          
            <ScrollViewer Grid.Row="1" Padding="3" VerticalScrollBarVisibility="Auto">                
                <StackPanel Orientation="Vertical">
                    <TextBlock Text="Base Symbol:" Margin="0,5,0,0"  FontWeight="Bold" />
                    <ComboBox x:Name="ColorRampCombo"  HorizontalAlignment="Left" SelectedIndex="0">
                        <ComboBoxItem Content="Red" Background="Red" />
                        <ComboBoxItem Content="Orange" Background="Orange" />
                        <ComboBoxItem Content="Yellow" Background="Yellow" />
                        <ComboBoxItem Content="Green" Background="Green" />
                        <ComboBoxItem Content="Blue" Background="Blue" />
                        <ComboBoxItem Content="Purple" Background="Purple" />
                        <ComboBoxItem Content="Magenta" Background="Magenta" />
                        <ComboBoxItem Content="Cyan" Background="Cyan" />
                        <ComboBoxItem Content="Black" Background="Black" Foreground="White"/>
                        <ComboBoxItem Content="White" Background="White"/>
                        <ComboBoxItem Content="Brown" Background="Brown"/>
                    </ComboBox>
                    <TextBlock Text="Start Color:" Margin="0,5,0,0"  FontWeight="Bold" />
                    <ComboBox x:Name="StartColorCombo" HorizontalAlignment="Left" SelectedIndex="0">
                        <ComboBoxItem Content="Red" Background="Red" />
                        <ComboBoxItem Content="Orange" Background="Orange" />
                        <ComboBoxItem Content="Yellow" Background="Yellow" />
                        <ComboBoxItem Content="Green" Background="Green" />
                        <ComboBoxItem Content="Blue" Background="Blue" />
                        <ComboBoxItem Content="Purple" Background="Purple" />
                        <ComboBoxItem Content="Magenta" Background="Magenta" />
                        <ComboBoxItem Content="Black" Background="Black" Foreground="White"/>
                        <ComboBoxItem Content="White" Background="White"/>
                        <ComboBoxItem Content="Brown" Background="Brown"/>
                        <ComboBoxItem Content="Cyan" Background="Cyan" />
                    </ComboBox>
                    <TextBlock Text="End Color:" Margin="0,5,0,0"  FontWeight="Bold" />
                    <ComboBox x:Name="EndColorCombo" HorizontalAlignment="Left" SelectedIndex="6" >
                        <ComboBoxItem Content="Red" Background="Red" />
                        <ComboBoxItem Content="Orange" Background="Orange" />
                        <ComboBoxItem Content="Yellow" Background="Yellow" />
                        <ComboBoxItem Content="Green" Background="Green" />
                        <ComboBoxItem Content="Blue" Background="Blue" />
                        <ComboBoxItem Content="Purple" Background="Purple" />
                        <ComboBoxItem Content="Magenta" Background="Magenta" />
                        <ComboBoxItem Content="Black" Background="Black" Foreground="White"/>
                        <ComboBoxItem Content="White" Background="White"/>
                        <ComboBoxItem Content="Brown" Background="Brown"/>
                        <ComboBoxItem Content="Cyan" Background="Cyan" />
                    </ComboBox>
                    <TextBlock Text="Algorithm :" Margin="0,5,0,0"  FontWeight="Bold" />
                    <ComboBox x:Name="AlgorithmCombo" HorizontalAlignment="Left" Width="150">
                        <ComboBox.ItemTemplate>
                            <DataTemplate>
                                <TextBlock Text="{Binding}"/>
                            </DataTemplate>
                        </ComboBox.ItemTemplate>
                    </ComboBox>
                    <TextBlock Text="Classification Field :" Margin="0,5,0,0"  FontWeight="Bold" />
                    <ComboBox x:Name="ClassificationFieldCombo" HorizontalAlignment="Left" MaxWidth="200" Width="150">
                        <ComboBox.ItemTemplate>
                            <DataTemplate>
                                <TextBlock Text="{Binding Name}"/>
                            </DataTemplate>
                        </ComboBox.ItemTemplate>
                    </ComboBox>
                    <TextBlock Text="Method :" Margin="0,5,0,0"  FontWeight="Bold" />
                    <ComboBox x:Name="ClassificationMethodCombo" SelectionChanged="ClassificationMethodCombo_SelectionChanged" HorizontalAlignment="Left" Width="150">
                        <ComboBox.ItemTemplate>
                            <DataTemplate>
                                <TextBlock Text="{Binding}"/>
                            </DataTemplate>
                        </ComboBox.ItemTemplate>
                    </ComboBox>
                    <TextBlock Text="Interval:" Margin="0,5,0,0"  FontWeight="Bold" />
                    <ComboBox x:Name="IntervalCombo" HorizontalAlignment="Left">
                        <ComboBox.ItemTemplate>
                            <DataTemplate>
                                <TextBlock Text="{Binding}"/>
                            </DataTemplate>
                        </ComboBox.ItemTemplate>
                    </ComboBox>
                    <TextBlock Text="Break Count:" Margin="0,5,0,0"  FontWeight="Bold" />
                    <TextBox x:Name="BreakCountTb" Text="5" HorizontalAlignment="Left" MinWidth="20"/>
                    <TextBlock Text="Normalization Type :" Margin="0,5,0,0"  FontWeight="Bold" />
                    <ComboBox x:Name="NormalizationTypeCombo" SelectionChanged="NormalizationTypeCombo_SelectionChanged" HorizontalAlignment="Left" >
                        <ComboBox.ItemTemplate>
                            <DataTemplate>
                                <TextBlock Text="{Binding}"/>
                            </DataTemplate>
                        </ComboBox.ItemTemplate>
                    </ComboBox>
                    <TextBlock Text="Normalization Field :" Margin="0,5,0,0"  FontWeight="Bold" />
                    <ComboBox x:Name="NormalizationFieldCombo" HorizontalAlignment="Left" IsEnabled="False">
                        <ComboBox.ItemTemplate>
                            <DataTemplate>
                                <TextBlock Text="{Binding Name}"/>
                            </DataTemplate>
                        </ComboBox.ItemTemplate>
                    </ComboBox>
                </StackPanel>
            </ScrollViewer>
            <Button x:Name="RenderButton" IsEnabled="False" Content="Apply" 
                Click="RenderButton_Click" Width="100" Margin="5" Grid.Row="2" />
        </Grid>
        </Canvas>
        </StackPanel>
    </Grid>
    </StackPanel>     
    </Grid>
</UserControl>

C#

using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Linq;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using ESRI.ArcGIS.Client;
using ESRI.ArcGIS.Client.Tasks;

namespace ArcGISWPFSDK
{
  
    public partial class DynamicLayersThematic : UserControl
    {

        GenerateRendererTask generateRendererTask;
        ColorRamp colorRamp;
        GenerateRendererParameters generateClassesParameters;

        public DynamicLayersThematic()
        {
            InitializeComponent();

            PopulateCombos();

            InitializeRenderingInfo();
        }

        private void FeatureLayer_Initialized(object sender, EventArgs e)
        {
            FeatureLayer featureLayer = sender as FeatureLayer;
            IEnumerable<Field> intandDoublefields =
              from fld in featureLayer.LayerInfo.Fields
              where fld.Type == Field.FieldType.Integer || fld.Type == Field.FieldType.Double
              select fld;
            if (intandDoublefields != null && intandDoublefields.Count() > 0)
            {
                ClassificationFieldCombo.ItemsSource = intandDoublefields;
                ClassificationFieldCombo.SelectedIndex = 1;
                NormalizationFieldCombo.ItemsSource = intandDoublefields;
                NormalizationFieldCombo.SelectedIndex = -1;
                RenderButton.IsEnabled = true;
            }
        }

        private void PopulateCombos()
        {
            AlgorithmCombo.ItemsSource = new object[] 
			{
			    Algorithm.CIELabAlgorithm, 
			    Algorithm.HSVAlgorithm, 
			    Algorithm.LabLChAlgorithm 
			};
            AlgorithmCombo.SelectedIndex = 1;

            ClassificationMethodCombo.ItemsSource = new object[] 
			{ 
			    ClassificationMethod.EqualInterval, 
			    ClassificationMethod.NaturalBreaks,
			    ClassificationMethod.Quantile, 
			    ClassificationMethod.StandardDeviation
			};
            ClassificationMethodCombo.SelectedIndex = 0;

            NormalizationTypeCombo.ItemsSource = new object[]
			{
			    NormalizationType.Field,
			    NormalizationType.Log,          
                NormalizationType.PercentOfTotal,
                NormalizationType.None
			};
            NormalizationTypeCombo.SelectedIndex = 3;

            IntervalCombo.ItemsSource = new object[]
			{
			    StandardDeviationInterval.One,
			    StandardDeviationInterval.OneHalf,
			    StandardDeviationInterval.OneQuarter,
			    StandardDeviationInterval.OneThird
			};
            IntervalCombo.SelectedIndex = 0;
        }

        private void InitializeRenderingInfo()
        {
            FeatureLayer statesFeatureLayer = MyMap.Layers["StatesFeatureLayer"] as FeatureLayer;

            generateRendererTask = new GenerateRendererTask(statesFeatureLayer.Url);

            generateClassesParameters = new GenerateRendererParameters();
            generateClassesParameters.Source = new LayerMapSource() { MapLayerID = 3 };

            generateRendererTask.Failed += (s, e) =>
            {
                MessageBox.Show(string.Format("GenerateRendererTask Failed: {0}", e.Error.Message));
            };
            generateRendererTask.ExecuteCompleted += (s, e) =>
            {
                statesFeatureLayer.Renderer = e.GenerateRendererResult.Renderer;
            };
        }

        private void RenderButton_Click(object sender, RoutedEventArgs e)
        {
            ObservableCollection<ColorRamp> colorRamps = new ObservableCollection<ColorRamp>();
            colorRamp = new ColorRamp()
            {
                From = ((StartColorCombo.SelectedItem as ComboBoxItem).Background as SolidColorBrush).Color,
                To = ((EndColorCombo.SelectedItem as ComboBoxItem).Background as SolidColorBrush).Color,
                Algorithm = (Algorithm)AlgorithmCombo.SelectedItem,
            };
            colorRamps.Add(colorRamp);

            generateClassesParameters.ClassificationDefinition = new ClassBreaksDefinition()
            {
                BaseSymbol = new ESRI.ArcGIS.Client.Symbols.SimpleFillSymbol()
                {
                    Fill = (ColorRampCombo.SelectedItem as ComboBoxItem).Background
                },
                ClassificationField = ((ClassificationFieldCombo.SelectedItem) as Field).Name,
                ClassificationMethod = (ClassificationMethod)ClassificationMethodCombo.SelectedItem,

                BreakCount = int.Parse(BreakCountTb.Text.Trim()),
                ColorRamps = colorRamps,
            };

            ClassBreaksDefinition classBreakDef =
                generateClassesParameters.ClassificationDefinition as ClassBreaksDefinition;

            if (classBreakDef.ClassificationMethod == ClassificationMethod.StandardDeviation)
                classBreakDef.StandardDeviationInterval = (StandardDeviationInterval)IntervalCombo.SelectedItem;

            if (NormalizationTypeCombo.SelectedItem != null)
            {
                classBreakDef.NormalizationType = (NormalizationType)NormalizationTypeCombo.SelectedItem;

                if (classBreakDef.NormalizationType == NormalizationType.Field)
                {
                    if (NormalizationFieldCombo.SelectedItem != null)
                        classBreakDef.NormalizationField = ((NormalizationFieldCombo.SelectedItem) as Field).Name;
                    else
                    {
                        MessageBox.Show("Normalization Field must be selected");
                        return;
                    }
                }
            }
            if (generateRendererTask.IsBusy)
                generateRendererTask.CancelAsync();
            generateRendererTask.ExecuteAsync(generateClassesParameters);
        }

        private void ClassificationMethodCombo_SelectionChanged(object sender, SelectionChangedEventArgs e)
        {
            ClassificationMethod method = (ClassificationMethod)(sender as ComboBox).SelectedItem;
            IntervalCombo.IsEnabled = (method == ClassificationMethod.StandardDeviation) ? true : false;
            BreakCountTb.IsEnabled = (method == ClassificationMethod.StandardDeviation) ? false : true;
        }

        private void NormalizationTypeCombo_SelectionChanged(object sender, SelectionChangedEventArgs e)
        {
            NormalizationType normType = (NormalizationType)(sender as ComboBox).SelectedItem;
            NormalizationFieldCombo.IsEnabled = (normType == NormalizationType.Field) ? true : false;
        }
    }
}

VB.NET

Imports System
Imports System.Collections
Imports System.Collections.Generic
Imports System.Linq
Imports System.Windows
Imports System.Windows.Controls
Imports ESRI.ArcGIS.Client
Imports ESRI.ArcGIS.Client.Tasks
Imports System.Windows.Media
Imports System.Collections.ObjectModel

Namespace ArcGISWPFSDK
    Partial Public Class DynamicLayersThematic
        Inherits UserControl

        Private generateRendererTask As GenerateRendererTask
        Private colorRamp As ColorRamp

        Private generateClassesParameters As GenerateRendererParameters

        Public Sub New()
            InitializeComponent()
            PopulateCombos()
            InitializeRenderingInfo()
        End Sub

        Private Sub FeatureLayer_Initialized(ByVal sender As Object, ByVal e As EventArgs)
            Dim featureLayer As FeatureLayer = TryCast(sender, FeatureLayer)
            Dim intandDoublefields As IEnumerable(Of Field) = From fld In featureLayer.LayerInfo.Fields Where fld.Type = Field.FieldType.Integer OrElse fld.Type = Field.FieldType.Double Select fld
            If Not intandDoublefields Is Nothing AndAlso intandDoublefields.Count() > 0 Then
                ClassificationFieldCombo.ItemsSource = intandDoublefields
                ClassificationFieldCombo.SelectedIndex = 1
                NormalizationFieldCombo.ItemsSource = intandDoublefields
                NormalizationFieldCombo.SelectedIndex = -1
                RenderButton.IsEnabled = True
            End If
        End Sub

        Private Sub PopulateCombos()
            AlgorithmCombo.ItemsSource = New Object() {Algorithm.CIELabAlgorithm, Algorithm.HSVAlgorithm, Algorithm.LabLChAlgorithm}
            AlgorithmCombo.SelectedIndex = 1

            ClassificationMethodCombo.ItemsSource = New Object() {ClassificationMethod.EqualInterval, ClassificationMethod.NaturalBreaks, ClassificationMethod.Quantile, ClassificationMethod.StandardDeviation}
            ClassificationMethodCombo.SelectedIndex = 0

            NormalizationTypeCombo.ItemsSource = New Object() {NormalizationType.Field, NormalizationType.Log, NormalizationType.PercentOfTotal, NormalizationType.None}
            NormalizationTypeCombo.SelectedIndex = 3

            IntervalCombo.ItemsSource = New Object() {StandardDeviationInterval.One, StandardDeviationInterval.OneHalf, StandardDeviationInterval.OneQuarter, StandardDeviationInterval.OneThird}
            IntervalCombo.SelectedIndex = 0
        End Sub

        Private Sub InitializeRenderingInfo()

            Dim statesFeatureLayer As FeatureLayer = TryCast(MyMap.Layers("StatesFeatureLayer"), FeatureLayer)

            generateClassesParameters = New GenerateRendererParameters()

            generateRendererTask = New GenerateRendererTask(statesFeatureLayer.Url)
            generateClassesParameters.Source = New LayerMapSource() With {.MapLayerID = 3}

            AddHandler generateRendererTask.Failed, Sub(s, e)
                                                        MessageBox.Show(String.Format("GenerateRendererTask Failed: {0}", e.Error.Message.ToString))
                                                    End Sub
            AddHandler generateRendererTask.ExecuteCompleted, Sub(s, e)
                                                                  statesFeatureLayer.Renderer = e.GenerateRendererResult.Renderer
                                                              End Sub
        End Sub

        Private Sub RenderButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
            Dim colorRamps As ObservableCollection(Of ColorRamp) = New ObservableCollection(Of ColorRamp)()
            colorRamp = New ColorRamp() With
                        {
                          .From = (TryCast(TryCast(StartColorCombo.SelectedItem, ComboBoxItem).Background, SolidColorBrush)).Color,
                          .To = (TryCast(TryCast(EndColorCombo.SelectedItem, ComboBoxItem).Background, SolidColorBrush)).Color,
                          .Algorithm = CType(AlgorithmCombo.SelectedItem, Algorithm)
                        }
            colorRamps.Add(colorRamp)


            generateClassesParameters.ClassificationDefinition = New ClassBreaksDefinition() With
                                                                 {
            .BaseSymbol = New ESRI.ArcGIS.Client.Symbols.SimpleFillSymbol() With
                         {.Fill = (TryCast(ColorRampCombo.SelectedItem, ComboBoxItem)).Background},
            .BreakCount = Integer.Parse(BreakCountTb.Text.Trim()),
            .ColorRamps = colorRamps,
            .ClassificationMethod = CType(ClassificationMethodCombo.SelectedItem, ClassificationMethod),
            .ClassificationField = (TryCast((ClassificationFieldCombo.SelectedItem), Field)).Name
            }

            Dim classBreakDef As ClassBreaksDefinition =
              TryCast(generateClassesParameters.ClassificationDefinition, ClassBreaksDefinition)

            If classBreakDef.ClassificationMethod = ClassificationMethod.StandardDeviation Then
                classBreakDef.StandardDeviationInterval = CType(IntervalCombo.SelectedItem, StandardDeviationInterval)
            End If

            If Not NormalizationTypeCombo.SelectedItem Is Nothing Then
                classBreakDef.NormalizationType = CType(NormalizationTypeCombo.SelectedItem, NormalizationType)

                If classBreakDef.NormalizationType = NormalizationType.Field Then
                    If Not NormalizationFieldCombo.SelectedItem Is Nothing Then
                        classBreakDef.NormalizationField = (TryCast((NormalizationFieldCombo.SelectedItem), Field)).Name
                    Else
                        MessageBox.Show("Normalization Field must be selected")
                        Return
                    End If
                End If
            End If
            If generateRendererTask.IsBusy Then
                generateRendererTask.CancelAsync()
            End If
            generateRendererTask.ExecuteAsync(generateClassesParameters)
        End Sub


        Private Sub ClassificationMethodCombo_SelectionChanged(ByVal sender As Object, ByVal e As SelectionChangedEventArgs)

            Dim method As ClassificationMethod = CType(TryCast(sender, ComboBox).SelectedItem, ClassificationMethod)
            If (method = ClassificationMethod.StandardDeviation) Then
                IntervalCombo.IsEnabled = True
            Else
                IntervalCombo.IsEnabled = False
            End If
            If (method = ClassificationMethod.StandardDeviation) Then
                BreakCountTb.IsEnabled = False
            Else
                BreakCountTb.IsEnabled = True
            End If
        End Sub

        Private Sub NormalizationTypeCombo_SelectionChanged(ByVal sender As Object, ByVal e As SelectionChangedEventArgs)

            Dim normType As NormalizationType = CType(TryCast(sender, ComboBox).SelectedItem, NormalizationType)
            If (normType = NormalizationType.Field) Then
                NormalizationFieldCombo.IsEnabled = True
            Else
                NormalizationFieldCombo.IsEnabled = False
            End If
        End Sub

    End Class
End Namespace