Visual Studio でのデータへの WPF コントロールのバインド

[アーティクル]
08/09/2011

データを WPF コントロールにバインドすることで、アプリケーションのユーザーに対してデータを表示できます。これらのデータバインドコントロールを作成するには、[データソース] ウィンドウから Visual Studio の WPF デザイナーに項目をドラッグします。このトピックでは、データバインド WPF アプリケーションの作成に使用できる最も一般的なタスク、ツール、およびクラスについて説明します。

Visual Studio でデータバインドコントロールを作成する方法に関する一般的な情報については、「Visual Studio でのデータへのコントロールのバインド」を参照してください。WPF のデータバインドの詳細については、「データバインディングの概要」を参照してください。

データへの WPF コントロールのバインドに関連するタスク

次の表に、[データソース] ウィンドウから WPF デザイナーに項目をドラッグすることで実行できるタスクを示します。

タスク	詳細情報
データバインドコントロールを作成する。既存のコントロールをデータにバインドする。	方法: Visual Studio でデータに WPF コントロールをバインドする
親子のリレーションシップを持つ関連データを表示するコントロールを作成する。あるコントロールの親データレコードを選択すると、その選択レコードに関連する子データが別のコントロールに表示されるようにします。	方法: WPF アプリケーションで関連データを表示する
あるテーブルの外部キーフィールドの値に基づいて、別のテーブルの情報を表示するルックアップテーブルを作成する。	方法: WPF アプリケーションでルックアップテーブルを作成する
コントロールをデータベース内のイメージにバインドする。	方法: データベースの画像にコントロールをバインドする

有効なドロップターゲット

[データソース] ウィンドウ内の項目は、WPF デザイナーの有効なドロップターゲットにのみドラッグできます。有効なドロップターゲットの種類は、主にコンテナーとコントロールの 2 つです。コンテナーとは、通常はコントロールを含むユーザーインターフェイス要素です。たとえば、グリッドやウィンドウはコンテナーです。

生成される XAML およびコード

[データソース] ウィンドウから WPF デザイナーに項目をドラッグすると、Visual Studio は、新しいデータバインドコントロールを定義する (または、既存のコントロールをデータソースにバインドする) XAML を生成します。一部のデータソースでは、Visual Studio により、データソースにデータを読み込むためのコードも分離コードファイルに生成されます。

次の表に、Visual Studio で [データソース] ウィンドウの各データソースに対して生成される XAML とコードを示します。

データソース	コントロールをデータソースにバインドする XAML の生成	データソースにデータを読み込むコードの生成
データセット	○	○
エンティティデータモデル	○	○
サービス	○	×
オブジェクト	○	×

データセット

[データソース] ウィンドウからデザイナーにテーブルまたは列をドラッグすると、Visual Studio は、次の処理を行う XAML を生成します。

項目をドラッグした先のコンテナーのリソースに、データセットと新しい CollectionViewSource を追加する。 CollectionViewSource は、データセットのデータの移動と表示に使用できるオブジェクトです。
コントロールのデータバインディングを作成する。デザイナーの既存のコントロールに項目をドラッグすると、XAML により、その項目にコントロールがバインドされます。コンテナーに項目をドラッグすると、XAML により、ドラッグした項目に対して選択されたコントロールが作成され、そのコントロールが項目にバインドされます。コントロールは、新しい Grid 内に作成されます。

Visual Studio は、分離コードファイルに次の変更も加えます。

コントロールを格納する UI 要素の Loaded イベントハンドラーを作成する。イベントハンドラーは、テーブルにデータを読み込み、コンテナーのリソースから CollectionViewSource を取得して、最初のデータ項目を現在の項目にします。 Loaded イベントハンドラーが既に存在する場合、Visual Studio はこのコードを既存のイベントハンドラーに追加します。

Entity Data Model

[データソース] ウィンドウからデザイナーにエンティティまたはエンティティプロパティをドラッグすると、Visual Studio は、次の処理を行う XAML を生成します。

項目をドラッグした先のコンテナーのリソースに、新しい CollectionViewSource を追加する。 CollectionViewSource は、エンティティのデータの移動と表示に使用できるオブジェクトです。
コントロールのデータバインディングを作成する。デザイナーの既存のコントロールに項目をドラッグすると、XAML により、その項目にコントロールがバインドされます。コンテナーに項目をドラッグすると、XAML により、ドラッグした項目に対して選択されたコントロールが作成され、そのコントロールが項目にバインドされます。コントロールは、新しい Grid 内に作成されます。

Visual Studio は、分離コードファイルに次の変更も加えます。

デザイナーにドラッグされたエンティティ (または、デザイナーにドラッグされたプロパティを含むエンティティ) のクエリを返す新しいメソッドを追加する。新しいメソッドには GetEntityNameQuery という名前が付けられます。EntityName はエンティティの名前です。
コントロールを格納する UI 要素の Loaded イベントハンドラーを作成する。イベントハンドラーは、GetEntityNameQuery メソッドを呼び出してエンティティにデータを読み込み、コンテナーのリソースから CollectionViewSource を取得して、最初のデータ項目を現在の項目にします。 Loaded イベントハンドラーが既に存在する場合、Visual Studio はこのコードを既存のイベントハンドラーに追加します。

サービス

[データソース] ウィンドウからデザイナーにサービスオブジェクトまたはプロパティをドラッグすると、Visual Studio は、データバインドコントロールを作成する (または、既存のコントロールをオブジェクトやプロパティにバインドする) XAML を生成します。ただし、Visual Studio はプロキシサービスオブジェクトにデータを読み込むコードを生成しません。このコードは、ユーザーが手動で記述する必要があります。この方法を示す例については、「チュートリアル: WCF Data Service への WPF コントロールのバインド」を参照してください。

Visual Studio は、次の処理を行う XAML を生成します。

項目をドラッグした先のコンテナーのリソースに、新しい CollectionViewSource を追加する。 CollectionViewSource は、サービスから返されるオブジェクトのデータの移動と表示に使用できるオブジェクトです。
コントロールのデータバインディングを作成する。デザイナーの既存のコントロールに項目をドラッグすると、XAML により、その項目にコントロールがバインドされます。コンテナーに項目をドラッグすると、XAML により、ドラッグした項目に対して選択されたコントロールが作成され、そのコントロールが項目にバインドされます。コントロールは、新しい Grid 内に作成されます。

オブジェクト

[データソース] ウィンドウからデザイナーにオブジェクトまたはプロパティをドラッグすると、Visual Studio は、データバインドコントロールを作成する (または、既存のコントロールをオブジェクトやプロパティにバインドする) XAML を生成します。ただし、Visual Studio はオブジェクトにデータを読み込むコードを生成しません。このコードは、ユーザーが手動で記述する必要があります。

注意

カスタムクラスはパブリックで、既定のパラメーターなしのコンストラクターを備えている必要があります。構文に "ドット" が含まれる入れ子になったクラスにすることはできません。詳細については、「WPF における XAML とカスタムクラス」を参照してください。