クエリタスク（QueryTask クラス）

61 XAML

<UserControl x:Class="Sample.MainPage"

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.Resources>

<esri:SimpleFillSymbol

x:Name="ResultsFillSymbol" Fill="#500000FF"

BorderBrush="Blue" BorderThickness="1" />

</Grid.Resources>

<esri:Map x:Name="MyMap" Extent="-80.05,36.93,-68.79,43.18" >

<esri:Map.Layers>

<esri:ArcGISTiledMapServiceLayer ID="StreetMapLayer"

Url="http://server.arcgisonline.com/ArcGIS/rest/

services/ESRI_StreetMap_World_2D/MapServer"/>

<esri:GraphicsLayer ID="MyGraphicsLayer">

<esri:GraphicsLayer.MapTip>

<TextBlock Text="{Binding [STATE_NAME]}"

FontWeight="Bold" />

</StackPanel>

</Grid>

</esri:GraphicsLayer.MapTip>

</esri:GraphicsLayer>

</esri:Map.Layers>

</esri:Map>

62 <Canvas HorizontalAlignment="Right" VerticalAlignment="Top"

Margin="0,15,7,0" Width="250" >

<Rectangle Fill="#CC5C90B2" Stroke="Gray" RadiusX="10"

RadiusY="10" Width="250" Height="55" />

<TextBlock Text="検索条件を入力して実行ボタンをクリックします"

Foreground="White" FontSize="10" Margin="10,5,0,0" />

<TextBox x:Name="QueryTextBox" Width="150" Margin="15,22,0,0"

Text="POP07_SQMI > 500" />

<Button x:Name="QueryButton" Content="実行" Margin="168,23,0,0"

Click="QueryButton_Click" />

</Canvas>

</Grid>

</UserControl>

63 コードビハインド

using System.Windows;

using System.Windows.Controls;

using System.Windows.Media;

using ESRI.ArcGIS.Client;

using ESRI.ArcGIS.Client.Tasks;

using ESRI.ArcGIS.Client.Symbols;

namespace Sample {

public partial class MainPage : UserControl {

public MainPage() {

InitializeComponent();

}

// 実行ボタンがクリックされたらクエリタスクを実行

private void QueryButton_Click(object sender, RoutedEventArgs e) {

// クエリタスクの初期化

QueryTask queryTask = new

QueryTask("http://sampleserver1.arcgisonline.com/ArcGIS/rest/" + "services/Demographics/ESRI_Census_USA/MapServer/5");

queryTask.ExecuteCompleted += QueryTask_ExecuteCompleted;

queryTask.Failed += QueryTask_Failed;

// クエリタスクの入力パラメータ：

図形情報、州名（STATE_NAME）、人口密度（POP07_SQMI）を返す

Query query = new Query();

query.ReturnGeometry = true;

query.OutFields.AddRange(new string[] { "STATE_NAME", "POP07_SQMI" });

// TextBox のテキストを検索条件に設定 query.Where = QueryTextBox.Text;

queryTask.ExecuteAsync(query);

64 }

// クエリタスクが完了したら結果を描画

private void QueryTask_ExecuteCompleted(object sender,

ESRI.ArcGIS.Client.Tasks.QueryEventArgs args)

{

// 前回の結果をクリゕ

GraphicsLayer graphicsLayer = MyMap.Layers["MyGraphicsLayer"] as

GraphicsLayer;

graphicsLayer.ClearGraphics();

// 新しい結果を検証

FeatureSet featureSet = args.FeatureSet;

if (featureSet.Features.Count > 0) {

// 結果をマップに追加

foreach (Graphic resultFeature in featureSet.Features) {

resultFeature.Symbol = ResultsFillSymbol;

graphicsLayer.Graphics.Add(resultFeature);

} } else {

MessageBox.Show("該当するフィーチャが見つかりません");

} }

// クエリタスク失敗時の処理

private void QueryTask_Failed(object sender, TaskFailedEventArgs args) {

MessageBox.Show("クエリが失敗しました: " + args.Error);

} } }

クエリタスク（サンプルコード）の解説

以下では前述したサンプルコードの内容について解説します。コードの全文についてはこちらをご参照ください。

クエリタスクの入力インタフェースの作成

タスクは固定のユーザ゗ンタフェースを持たないため、開発者はユーザが検索条件を入力しクエリタスクを実行するための゗ンタフェースを作成する必要があります。このサンプルコードでは、検索条件を入力するための TextBox コントロール、タスクを実行するための Button コントロールを作成します。

ゕプリケーションの XAML コードに゗ンタフェースを保持する Canvas コントロールを追加 1.

します。

<Canvas HorizontalAlignment="Right" VerticalAlignment="Top"

Margin="0,15,7,0" Width="250" ></Canvas>

゗ンタフェースの背景に使用する Rectangle コントロールを追加します。

<Canvas HorizontalAlignment="Right" VerticalAlignment="Top"

Margin="0,15,7,0" Width="250" >

<Rectangle Fill="#CC5C90B2" Stroke="Gray" RadiusX="10" RadiusY="10"

Width="250" Height="55" />

</Canvas>

ユーザに使用方法を通知する TextBlock コントロールを追加します。

<Canvas HorizontalAlignment="Right" VerticalAlignment="Top"

Margin="0,15,7,0" Width="250" >

<Rectangle Fill="#CC5C90B2" Stroke="Gray" RadiusX="10" RadiusY="10"

Width="250" Height="55" />

<TextBlock Text="検索条件を入力して実行ボタンをクリックします"

Foreground="White" FontSize="10" Margin="10,5,0,0" />

</Canvas>

検索条件を入力する TextBox コントロールを追加します。

<Canvas HorizontalAlignment="Right" VerticalAlignment="Top"

Margin="0,15,7,0" Width="250" >

<Rectangle Fill="#CC5C90B2" Stroke="Gray" RadiusX="10" RadiusY="10"

Width="250" Height="55" />

<TextBlock Text="検索条件を入力して実行ボタンをクリックします"

Foreground="White" FontSize="10" Margin="10,5,0,0" />

</Canvas>

66 既定の検索条件を指定します。

<Canvas HorizontalAlignment="Right" VerticalAlignment="Top"

Margin="0,15,7,0" Width="250" >

<Rectangle Fill="#CC5C90B2" Stroke="Gray" RadiusX="10" RadiusY="10"

Width="250" Height="55" />

<TextBlock Text="検索条件を入力して実行ボタンをクリックします"

Foreground="White" FontSize="10" Margin="10,5,0,0" />

<TextBox x:Name="QueryTextBox" Width="150" Margin="15,22,0,0"

Text="POP07_SQMI > 500" />

</Canvas>

クエリタスクを実行するための Button コントロールを追加します。

<Canvas HorizontalAlignment="Right" VerticalAlignment="Top"

Margin="0,15,7,0" Width="250" >

<Rectangle Fill="#CC5C90B2" Stroke="Gray" RadiusX="10" RadiusY="10"

Width="250" Height="55" />

<TextBlock Text="検索条件を入力して実行ボタンをクリックします"

Foreground="White" FontSize="10" Margin="10,5,0,0" />

<TextBox x:Name="QueryTextBox" Width="150" Margin="15,22,0,0"

Text="POP07_SQMI > 500" />

</Canvas>

Button コントロールがクリックされた際の゗ベントハンドラをゕタッチします（ハンドラの 7.

実装方法については「クエリタスク実行ロジックの実装」で解説します）。

<Canvas HorizontalAlignment="Right" VerticalAlignment="Top"

Margin="0,15,7,0" Width="250" >

<Rectangle Fill="#CC5C90B2" Stroke="Gray" RadiusX="10" RadiusY="10"

Width="250" Height="55" />

<TextBlock Text="検索条件を入力して実行ボタンをクリックします"

Foreground="White" FontSize="10" Margin="10,5,0,0" />

<TextBox x:Name="QueryTextBox" Width="150" Margin="15,22,0,0"

Text="POP07_SQMI > 500" />

<Button x:Name="QueryButton" Content="実行" Margin="168,23,0,0"

Click="QueryButton_Click" />

</Canvas>

67 クエリタスクの出力インタフェースの作成

タスクの実行結果を表示するためには出力゗ンタフェースを作成する必要があります。サンプルゕプリケーションでは、マップにグラフゖックスレ゗ヤを追加し、タスクの結果を描画します。また、結果のグラフゖックの属性情報を表示するためにグラフゖックスレ゗ヤにマップチップを追加します。

1. 検索結果に使用するシンボルをリソースとして定義します（シンボルについての詳細は「シンボルとレンダラ」を参照してください）。

<Grid.Resources>

<esri:SimpleFillSymbol x:Name="ResultsFillSymbol" Fill="#500000FF"

BorderBrush="Blue" BorderThickness="1" />

</Grid.Resources>

2. これ以降の手順では、下記の例のように XAML にマップが追加されており、背景用のマップサービスレ゗ヤが 1 つ追加されている状態から、出力゗ンタフェースを作成する手順の解説をします。

<esri:Map x:Name="MyMap" Extent="-80.05,36.93,-68.79,43.18" >

<esri:Map.Layers>

<esri:ArcGISTiledMapServiceLayer ID="StreetMapLayer"

Url="http://server.arcgisonline.com/ArcGIS/rest/

services/ESRI_StreetMap_World_2D/MapServer"/>

</esri:Map.Layers>

</esri:Map>

68 マップに結果を表示するためのグラフゖックスレ゗ヤとして GraphicsLayer クラスを追加し 3.

ます (ID は「MyGraphicsLayer」)。GraphicsLayer クラスが他のレ゗ヤよりも上に表示されるように他のマップ内のレ゗ヤよりも下の行に追加されています。

<esri:Map x:Name="MyMap" Extent="-80.05,36.93,-68.79,43.18" >

<esri:Map.Layers>

<esri:ArcGISTiledMapServiceLayer ID="StreetMapLayer"

Url="http://server.arcgisonline.com/ArcGIS/rest/

services/ESRI_StreetMap_World_2D/MapServer"/>

<esri:GraphicsLayer ID="MyGraphicsLayer">

</esri:GraphicsLayer>

</esri:Map.Layers>

</esri:Map>

GraphicsLayer クラスの MapTip プロパテゖを設定します。MapTip プロパテゖには、レ゗ヤ 4.

のマップチップの背景と枠線を定義することができます。以下に示す例では Grid コントロール内に StackPanel コントロールと Border コントロールを配置して単純な長方形のマップチップを作成しています。マップチップの背景色は Grid コントロールの Background プロパテゖに指定し、枠線色は Border コントロールの BorderBrush プロパテゖに指定します。

マップチップのコンテナをこのように定義すると、マップチップの内容に応じてコンテナのサ゗ズは自動的に変更され、以下の手順ではコンテナ内に米国の州名と州の人口密度が表示されるように設定を行います。

<esri:Map x:Name="MyMap" Extent="-80.05,36.93,-68.79,43.18" >

<esri:Map.Layers>

<esri:ArcGISTiledMapServiceLayer ID="StreetMapLayer"

Url="http://server.arcgisonline.com/ArcGIS/rest/

services/ESRI_StreetMap_World_2D/MapServer"/>

<esri:GraphicsLayer ID="MyGraphicsLayer">

<esri:GraphicsLayer.MapTip>

</StackPanel>

</Grid>

</esri:GraphicsLayer.MapTip>

</esri:GraphicsLayer>

69 </esri:Map.Layers>

</esri:Map>

州名を保持するための TextBlock コントロールを追加します。

<esri:Map x:Name="MyMap" Extent="-80.05,36.93,-68.79,43.18" >

<esri:Map.Layers>

<esri:ArcGISTiledMapServiceLayer ID="StreetMapLayer"

Url="http://server.arcgisonline.com/ArcGIS/rest/

services/ESRI_StreetMap_World_2D/MapServer"/>

<esri:GraphicsLayer ID="MyGraphicsLayer">

<esri:GraphicsLayer.MapTip>

</StackPanel>

</Grid>

</esri:GraphicsLayer.MapTip>

</esri:GraphicsLayer>

</esri:Map.Layers>

</esri:Map>

70 追加した TextBlock コントロールの Text プロパテゖにグラフゖックの Attributes プロパ 6.

テゖをバ゗ンドします。グラフゖックの Attributes プロパテゖはフゖールド名としての Key と属性値としての Value のペゕのコレクションです。ここでは「STATE_NAME」を Key として指定し、STATE_NAME フゖールドの属性値を Text プロパテゖにバ゗ンドします。

<esri:Map x:Name="MyMap" Extent="-80.05,36.93,-68.79,43.18" >

<esri:Map.Layers>

<esri:ArcGISTiledMapServiceLayer ID="StreetMapLayer"

Url="http://server.arcgisonline.com/ArcGIS/rest/

services/ESRI_StreetMap_World_2D/MapServer"/>

<esri:GraphicsLayer ID="MyGraphicsLayer">

<esri:GraphicsLayer.MapTip>

</StackPanel>

</Grid>

</esri:GraphicsLayer.MapTip>

</esri:GraphicsLayer>

</esri:Map.Layers>

</esri:Map>

71 人口密度のラベルと値を格納する StackPanel コントロールを追加します。

<esri:Map x:Name="MyMap" Extent="-80.05,36.93,-68.79,43.18" >

<esri:Map.Layers>

<esri:ArcGISTiledMapServiceLayer ID="StreetMapLayer"

Url="http://server.arcgisonline.com/ArcGIS/rest/

services/ESRI_StreetMap_World_2D/MapServer"/>

<esri:GraphicsLayer ID="MyGraphicsLayer">

<esri:GraphicsLayer.MapTip>

</StackPanel>

</Grid>

</esri:GraphicsLayer.MapTip>

</esri:GraphicsLayer>

</esri:Map.Layers>

</esri:Map>

72 人口密度のラベルを表示する TextBlock コントロールを追加します。

<esri:Map x:Name="MyMap" Extent="-80.05,36.93,-68.79,43.18" >

<esri:Map.Layers>

<esri:ArcGISTiledMapServiceLayer ID="StreetMapLayer"

Url="http://server.arcgisonline.com/ArcGIS/rest/

services/ESRI_StreetMap_World_2D/MapServer"/>

<esri:GraphicsLayer ID="MyGraphicsLayer">

<esri:GraphicsLayer.MapTip>

</StackPanel>

</Grid>

</esri:GraphicsLayer.MapTip>

</esri:GraphicsLayer>

</esri:Map.Layers>

</esri:Map>

73 人口密度の値を表示する TextBlock コントロールを追加し、Text プロパテゖに

POP07_SQMI 列の属性値とバ゗ンドします。

<esri:Map x:Name="MyMap" Extent="-80.05,36.93,-68.79,43.18" >

<esri:Map.Layers>

<esri:ArcGISTiledMapServiceLayer ID="StreetMapLayer"

Url="http://server.arcgisonline.com/ArcGIS/rest/

services/ESRI_StreetMap_World_2D/MapServer"/>

<esri:GraphicsLayer ID="MyGraphicsLayer">

<esri:GraphicsLayer.MapTip>

</StackPanel>

</Grid>

</esri:GraphicsLayer.MapTip>

</esri:GraphicsLayer>

</esri:Map.Layers>

</esri:Map>

74 クエリタスク実行ロジックの実装

この手順では、クエリタスクの実行ロジックを実装します。クエリタスクの実行ロジックは、1) タスクの実行、2) 実行結果の表示、3) エラー制御の３つのパートに分けることができます。

以下ではこの 3 つの実行ロジックを Silverlight ゕプリケーションのメ゗ンページのコードビハ゗ンドフゔ゗ル（例：MainPage.xaml.cs）に記述します。コードビハ゗ンドでは、XAML に定義されたエレメントを x:name 属性や ID プロパテゖを使用して参照し利用します。以下の手順では、XAML に前述した「クエリタスク入力゗ンタフェースの作成」および「クエリタスク出力゗ンタフェースの作成」の手順に記述されているオブジェクトが定義されているものとして解説を行います。

クエリタスクの実行

タスクを実行するにはまず、タスクを初期化しクエリを実行するレ゗ヤを指定します。そして、タスクが完了した際の゗ベントハンドラを記述し、タスクの入力パラメータを指定して、タスクを実行するメソッドを呼び出します。以下では、これらのステップをコードビハ゗ンドフゔ゗ルに記述する方法を解説します。

1. コードビハ゗ンドに、XAML に定義した検索実行ボタン（QueryButton)の Click ゗ベントの

゗ベントハンドラを記述します。

private void QueryButton_Click(object sender, RoutedEventArgs e) {

}

2. Click ゗ベントの゗ベントハンドラ内で QueryTask クラスを初期化します。QueryTask クラスのコンストラクタにはクエリを実行する対象のマップサービスレ゗ヤの Url を指定します。

ArcGIS for Server のサービスレ゗ヤの URL は ArcGIS for Server の ArcGIS REST Services Direcotry で確認することができます。以下の例では、Esri 社がホストするサンプルサーバにホストされている米国州のマップサービスレ゗ヤの Url を指定しています。

private void QueryButton_Click(object sender, RoutedEventArgs e) {

QueryTask queryTask = new QueryTask("http://sampleserver1.arcgisonline.com/

ArcGIS/rest/services/" + "Demographics/ESRI_Census_USA/MapServer/5");

}

ドキュメント内 ArcGIS API for Silverlight プログラミングガイド (v3.x) (ページ 63-85)

クエリ タスク（QueryTask クラス）