このサンプルでは、Windows Presentation Foundation (WPF) クライアントでのデータ バインディングの使用方法を示します。このサンプルでは、アルバムの配列をランダムに生成してクライアントに返す Windows Communication Foundation (WCF) サービスを使用します。各アルバムには、名前、価格、およびアルバム トラックの一覧が含まれます。アルバム トラックには、名前と継続時間が含まれます。サービスによって返される情報は、Windows Presentation Foundation (WPF) クライアントが提供するユーザー インターフェイス (UI) に自動的にバインドされます。
![]() |
---|
このサンプルをビルドして実行するには、.NET Framework Version 3.5 をインストールする必要があります。プロジェクト ファイルとソリューション ファイルを開くには、Visual Studio 2008 が必要です。 |
![]() |
---|
このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。 |
データ バインディングでは、データ ソースを自動的に UI にバインドすることができます。これによってプログラミング モデルが簡素化されます。プログラムを使って、各 UI 要素をデータ オブジェクトまたはデータ オブジェクトの配列からのデータで更新する必要がないためです。オブジェクトは単一の UI 要素にバインドできます。または配列を複数の入力情報を取得する ListBox などのコントロールにバインドすることもできます。データを UI 要素の DataContext
にバインドする方法を次のコードに示します。
// Event handler executed when call is complete
void client_GetAlbumListCompleted(object sender, GetAlbumListCompletedEventArgs e)
{
// This is on the UI thread, myPanel can be accessed directly
myPanel.DataContext = e.Result;
}
前のサンプルでは、myPanel
という grid レイアウト要素の DataContext
が、GetAlbumList
メソッドによって返されるデータに設定されます。DataContext
では、バインディングに使用されるデータ ソースやその他のバインディング特性 (パスなど) に関する情報を、要素が親要素から継承できます。このコード行は、サーバー上のデータが更新されるたびに実行する必要があります。たとえば、ウィンドウが初期化されたり新しいアルバムが追加されたりするときに実行します。
次の XAML サンプル コードでは、ListBox
に ItemsSource="{Binding }"
を指定します。
<ListBox
ItemTemplate="{StaticResource AlbumStyle}"
ItemsSource="{Binding }"
IsSynchronizedWithCurrentItem="true" />
これは、最上位の UI 要素にバインドされるデータは、このコントロール (アルバムの配列) にもバインドされることを示します。また、ItemTemplate="{StaticResource AlbumStyle}"
では、データ テンプレートが ListBox
の各項目で使用されるように指定されます。データの書式設定方法を指定するデータ テンプレートを定義することもできます。こうしたデータ テンプレートは、アプリケーション内の他の UI 要素で再使用できます。この利点は、データ テンプレートを 1 つの場所で定義および維持できることです。
AlbumStyle
データ テンプレートでは、2 つの並列の TextBlock
を伴ってグリッドが配置されます。このうちの 1 つはアルバムの名前を指定し、もう 1 つはアルバムのトラック数を指定します。
<DataTemplate x:Key="AlbumStyle">
<Grid>
<Grid.ColumnDefinitions>
<ColumnDefinition Width="260" />
<ColumnDefinition Width="60" />
</Grid.ColumnDefinitions>
<TextBlock Grid.Column="0" TextContent="{Binding Path=Title}" />
<TextBlock Grid.Column="1" TextContent="{Binding Path=Tracks#.Count}" HorizontalAlignment="Right" />
</Grid>
</DataTemplate>
2 つ目の ListBox
を作成する XAML コードを次に示します。
<ListBox Grid.Row="2"
Grid.ColumnSpan="2"
ItemTemplate="{StaticResource TrackStyle}"
ItemsSource="{Binding Path=Tracks}" />
このコードは、ItemsSource
のパスを指定します。これは、このコントロールにバインドされるデータは最上位のデータではなく、Tracks
という最上位データのプロパティであることを示します。このプロパティは、アルバムに含まれるトラックの配列を表します。さらに、TrackStyle
という別の DataTemplate
が指定されています。TrackStyle
テンプレートのレイアウトは AlbumStyle
テンプレートのレイアウトに似ていますが、TextBlock
は別々のプロパティにバインドされます。これは、2 つのテンプレートが異なるデータ オブジェクトで使用されるためです。
サンプルを設定、ビルド、および実行するには
「Windows Communication Foundation サンプルの 1 回限りのセットアップの手順」が実行済みであることを確認します。
ソリューションの C# 版または Visual Basic .NET 版をビルドするには、「Windows Communication Foundation サンプルのビルド」の手順に従います。
サンプルを単一コンピュータ構成または複数コンピュータ構成で実行するには、「Windows Communication Foundation サンプルの実行」の手順に従います。
Copyright © 2007 by Microsoft Corporation.All rights reserved.