WCF Data Service への WPF コントロールのバインド

  • [アーティクル]

このチュートリアルでは、データ バインド コントロールが含まれた WPF アプリケーションを作成します。 コントロールは、WCF Data Service でカプセル化された顧客レコードにバインドされます。 また、顧客がレコードを表示および更新するために使用できるボタンも追加します。

このチュートリアルでは、次の作業について説明します。

  • AdventureWorksLT サンプル データベースのデータから生成される Entity Data Model を作成する。

  • WPF アプリケーションに Entity Data Model のデータを公開する WCF Data Service を作成する。

  • [データ ソース] ウィンドウから WPF デザイナーに項目をドラッグして、一連のデータ バインド コントロールを作成する。

  • 顧客レコード間を前後に移動するためのボタンを作成する。

  • コントロールでのデータに対する変更を WCF Data Service および基になるデータ ソースに保存するボタンを作成する。

Note

この記事で紹介する Visual Studio ユーザー インターフェイス要素の一部は、お使いのコンピューターでは名前や場所が異なる場合があります。 Visual Studio のエディションや環境設定がお使いのものと異なる場合があります。 詳細については、「Visual Studio IDE のカスタマイズ」を参照してください。

必須コンポーネント

このチュートリアルを実行するには、次のコンポーネントが必要です。

  • Visual Studio

  • AdventureWorksLT サンプル データベースが添付された、SQL Server または SQL Server Express の実行中のインスタンスへのアクセス権。 データベースをダウンロードするには、AdventureWorks サンプル データベースを参照してください

次の概念に関する知識があると役立ちますが、チュートリアルを実行するうえで必須というわけではありません。

サービス プロジェクトを作成する

  1. このチュートリアルでは、まず C# または Visual Basic の ASP.NET Web アプリケーション プロジェクトを作成します。 プロジェクトに AdventureWorksService という名前を指定します。

  2. ソリューション エクスプローラーで、Default.aspx を右クリックし、[削除] を選択します。 このファイルは、このチュートリアルでは必要ありません。

サービスの Entity Data Model を作成する

WCF Data Service を使用してアプリケーションにデータを公開するには、サービスのデータ モデルを定義する必要があります。 WCF Data Service では、Entity Data Model とカスタム データ モデルの 2 種類のデータ モデルがサポートされています。これらは、IQueryable<T> インターフェイスを実装する共通言語ランタイム (CLR) オブジェクトを使用して定義されます。 このチュートリアルでは、データ モデルとして Entity Data Model を作成します。

  1. [プロジェクト] メニューの [新しい項目の追加] をクリックします。

  2. [インストールされたテンプレート] ボックスの一覧で、[データ] をクリックし、[ADO.NET エンティティ データ モデル] プロジェクト項目を選択します。

  3. 名前を AdventureWorksModel.edmx に変更し、[追加] をクリックします。

    Entity Data Model ウィザードが開きます。

  4. [モデルのコンテンツの選択] ページで、[データベースから生成] をクリックし、[次へ] をクリックします。

  5. [データ接続の選択] ページで、次のいずれかのオプションを選択します。

    • AdventureWorksLT サンプル データベースへのデータ接続がドロップダウン リストに表示されている場合は、これを選択します。

    • [新しい接続] をクリックして、AdventureWorksLT データベースへの接続を作成します。

  6. [データ接続の選択] ページで、[エンティティ接続設定に名前を付けて App.Config に保存] オプションが選択されていることを確認し、[次へ] をクリックします。

  7. [データベース オブジェクトの選択] ページで、[テーブル] を展開し、SalesOrderHeader テーブルを選択します。

  8. [完了] をクリックします。

サービスの作成

WPF アプリケーションに Entity Data Model のデータを公開する WCF Data Service を作成します。

  1. [プロジェクト] メニューで、 [新しい項目の追加] を選択します。

  2. [インストールされたテンプレート] ボックスの一覧で、で、[Web] をクリックし、[WCF Data Service] プロジェクト項目を選択します。

  3. [名前] ボックスに「AdventureWorksService.svc」と入力して、[追加] をクリックします。

    Visual Studio によって、AdventureWorksService.svc がプロジェクトに追加されます。

サービスの構成

作成した Entity Data Model を操作するには、サービスを構成する必要があります。

  1. AdventureWorks.svc コード ファイルで、AdventureWorksService クラス宣言を次のコードで置き換えます。

    public class AdventureWorksService : DataService<AdventureWorksLTEntities>
{
    // This method is called only once to initialize service-wide policies.
    public static void InitializeService(IDataServiceConfiguration config)
    {
        config.SetEntitySetAccessRule("SalesOrderHeaders", EntitySetRights.All);
    }
}

    このコードにより AdventureWorksService クラスが更新されるため、それは、Entity Data Model の AdventureWorksLTEntities オブジェクト コンテキスト クラスを操作する DataService<T> から派生します。 また、InitializeService メソッドも更新され、SalesOrderHeader エンティティへの完全な読み取り/書き込みアクセスがサービスのクライアントに許可されます。

  2. プロジェクトをビルドし、エラーが発生しないことを確認します。

WPF クライアント アプリケーションを作成する

WCF Data Service のデータを表示するには、サービスに基づくデータ ソースを使用して、新しい WPF アプリケーションを作成します。 このチュートリアルの後半で、データ バインド コントロールをアプリケーションに追加します。

  1. ソリューション エクスプローラーで、ソリューション ノードを右クリックし、[追加] をクリックして、[新しいプロジェクト] を選択します。

  2. [新しいプロジェクト] ダイアログで、[Visual C#] または [Visual Basic] を展開し、[Windows] を選択します。

  3. [WPF アプリケーション] プロジェクト テンプレートを選択します。

  4. [名前] ボックスに AdventureWorksSalesEditor と入力して、[OK] をクリックします。

    Visual Studio によって AdventureWorksSalesEditor プロジェクトがソリューションに追加されます。

  5. [データ] メニューの [データ ソースの表示]をクリックします。

    [データ ソース] ウィンドウが開きます。

  6. [データ ソース] ウィンドウで、 [新しいデータ ソースの追加]をクリックします。

    データ ソース構成ウィザードが開きます。

  7. ウィザードの [データ ソースの種類を選択] ページで、[サービス] を選択し、[次へ] をクリックします。

  8. [サービス参照の追加] ダイアログ ボックスで、[探索] をクリックします。

    Visual Studio によって、使用できるサービスが現在のソリューションから検索され、[サービス] ボックスの使用できるサービスの一覧に AdventureWorksService.svc が追加されます。

  9. [名前空間] ボックスに「AdventureWorksService」と入力します。

  10. [サービス] ボックスで [AdventureWorksService.svc] をクリックし、[OK] をクリックします。

    Visual Studio によってサービス情報がダウンロードされ、データ ソース構成ウィザードに戻ります。

  11. [サービス参照の追加] ページで、[完了] をクリックします。

    Visual Studio によって、サービスから返されたデータを表すノードが [データ ソース] ウィンドウに追加されます。

ユーザー インターフェイスを定義する

WPF デザイナーで XAML を変更して、いくつかのボタンをウィンドウに追加します。 これらのボタンを使用して販売レコードを表示および更新できるようにするコードは、このチュートリアルで後で追加します。

  1. ソリューション エクスプローラーで、MainWindow.xaml をダブルクリックします。

    WPF デザイナーでウィンドウが開きます。

  2. デザイナーの XAML ビューで、<Grid> タグの間に次のコードを追加します。

    <Grid.RowDefinitions>
    <RowDefinition Height="75" />
    <RowDefinition Height="525" />
</Grid.RowDefinitions>
<Button HorizontalAlignment="Left" Margin="22,20,0,24" Name="backButton" Width="75"><</Button>
<Button HorizontalAlignment="Left" Margin="116,20,0,24" Name="nextButton" Width="75">></Button>
<Button HorizontalAlignment="Right" Margin="0,21,46,24" Name="saveButton" Width="110">Save changes</Button>

  3. プロジェクトをビルドします。

データ バインド コントロールを作成する

顧客レコードを表示するコントロールを作成するには、[データ ソース] ウィンドウからデザイナーに SalesOrderHeaders ノードをドラッグします。

  1. [データ ソース] ウィンドウで、[SalesOrderHeaders] ノードのドロップダウン リスト メニューをクリックし、[詳細] を選択します。

  2. [SalesOrderHeaders] ノードを展開します。

  3. この例ではいくつかのフィールドを非表示にするために、次のノードの横のドロップダウン リスト メニューをクリックして [なし] を選択します。

    • CreditCardApprovalCode

    • ModifiedDate

    • OnlineOrderFlag

    • RevisionNumber

    • rowguid

    この操作は、次の手順において、これらのノードに対応するデータ バインド コントロールが Visual Studio で作成されるのを防ぎます。 このチュートリアルでは、エンド ユーザーがこのデータを参照する必要がないことを前提としています。

  4. [データ ソース] ウィンドウから、ボタンのある行の下のグリッド行に [SalesOrderHeaders] ノードをドラッグします。

    Visual Studio によって、Product テーブルのデータにバインドされるコントロール セットを作成する XAML とコードが生成されます。 生成される XAML およびコードの詳細については、「Visual Studio でデータに WPF コントロールをバインドする」を参照してください。

  5. デザイナーで、[Customer ID] ラベルの横のテキスト ボックスをクリックします。

  6. [プロパティ] ウィンドウで、IsReadOnly プロパティの横のチェック ボックスをオンにします。

  7. 次の各テキスト ボックスに IsReadOnly プロパティを設定します。

    • [Purchase Order Number]

    • [Sales Order ID]

    • [Sales Order Number]

サービスからのデータの読み込み

サービスから販売データを読み込むには、サービス プロキシ オブジェクトを使用します。 その後、返されたデータを、WPF ウィンドウの CollectionViewSource のデータ ソースに割り当てます。

  1. 作成するため、デザイナーで、Window_Loadedイベント ハンドラーを読み取るテキストをダブルクリックしますMainWindow。

  2. イベント ハンドラーを次のコードで置き換えます。 このコードの localhost アドレスは、使用している開発コンピューターのローカル ホスト アドレスで置き換えてください。

    private AdventureWorksService.AdventureWorksLTEntities dataServiceClient;
private System.Data.Services.Client.DataServiceQuery<AdventureWorksService.SalesOrderHeader> salesQuery;
private CollectionViewSource ordersViewSource;

private void Window_Loaded(object sender, RoutedEventArgs e)
{
    // TODO: Modify the port number in the following URI as required.
    dataServiceClient = new AdventureWorksService.AdventureWorksLTEntities(
        new Uri("http://localhost:45899/AdventureWorksService.svc"));
    salesQuery = dataServiceClient.SalesOrderHeaders;

    ordersViewSource = ((CollectionViewSource)(this.FindResource("salesOrderHeadersViewSource")));
    ordersViewSource.Source = salesQuery.Execute();
    ordersViewSource.View.MoveCurrentToFirst();
}

ユーザーが <[] ボタンと >[] ボタンを使用して販売レコード間をスクロールできるようにするコードを追加します。

  1. デザイナーで、ウィンドウ サーフェイスの [<] をダブルクリックします。

    Visual Studio によって分離コード ファイルが開かれ、backButton_Click イベントのために新しい Click イベント ハンドラーが作成されます。

  2. 生成された backButton_Click イベント ハンドラーに次のコードを追加します。

    if (ordersViewSource.View.CurrentPosition > 0)
    ordersViewSource.View.MoveCurrentToPrevious();

  3. デザイナーに戻り、>[] をダブルクリックします。

    Visual Studio によって分離コード ファイルが開かれ、nextButton_Click イベントのために新しい Click イベント ハンドラーが作成されます。

  4. 生成された nextButton_Click イベント ハンドラーに次のコードを追加します。

    if (ordersViewSource.View.CurrentPosition < ((CollectionView)ordersViewSource.View).Count - 1)
{
    ordersViewSource.View.MoveCurrentToNext();
}

販売レコードの変更を保存する

ユーザーが販売レコードを表示し、[変更の保存] ボタンを使用して変更を保存できるようにするコードを追加します。

  1. デザイナーで、[変更の保存] をダブルクリックします。

    Visual Studio によって分離コード ファイルが開かれ、saveButton_Click イベントのために新しい Click イベント ハンドラーが作成されます。

  2. saveButton_Click イベント ハンドラーに次のコードを追加します。

    AdventureWorksService.SalesOrderHeader currentOrder = (AdventureWorksService.SalesOrderHeader)ordersViewSource.View.CurrentItem;
dataServiceClient.UpdateObject(currentOrder);
dataServiceClient.SaveChanges();

アプリケーションをテストする

アプリケーションをビルドして実行し、顧客レコードを表示および更新できることを確認します。

  1. [ビルド] メニューの [ソリューションのビルド] をクリックします。 ソリューションがエラーなしでビルドされることを確認します。

  2. Ctrl+F5 キーを押します。

    Visual Studio によって、AdventureWorksService プロジェクトがデバッグなしで開始されます。

  3. ソリューション エクスプローラーで、AdventureWorksSalesEditor プロジェクトを右クリックします。

  4. 右クリック メニュー (コンテキスト メニュー) の [デバッグ] で [新しいインスタンスを開始] をクリックします。

    アプリケーションが実行されます。 次のことを確認します。

    • テキスト ボックスに、先頭の販売レコードの各種データ フィールドが表示されること。このレコードの販売注文 ID は 71774 です。

    • >[] または <[] をクリックして、他の販売レコードに移動できること。

  5. いずれかの販売レコードの [コメント] ボックスに任意のテキストを入力し、[変更の保存] をクリックします。

  6. アプリケーションを終了し、Visual Studio からもう一度アプリケーションを起動します。

  7. 変更した販売レコードに移動し、アプリケーションを終了して再起動した後でも変更が保持されていることを確認します。

  8. アプリケーションを終了します。

次のステップ

このチュートリアルを完了した後、関連する次のタスクを実行できます。

  • Visual Studio の [データ ソース] ウィンドウを使用して、WPF コントロールをその他の種類のデータ ソースにバインドする方法について学習します。 詳細については、「データセットへの WPF コントロールのバインド」を参照してください。

  • Visual Studio の [データ ソース] ウィンドウを使用して、WPF コントロールでの関連するデータ (つまり、親子関係にあるデータ) を表示する方法について学習します。 詳細については、WPF アプリケーションでの関連データの表示に関するチュートリアルを参照してください。

関連するコンテンツ