.NET Framework アプリケーションのデータセットに WPF コントロールをバインドする

[アーティクル]
05/01/2023

Note

データセットと関連クラスは、アプリケーションがデータベースから切断されている間にアプリケーションがメモリ内のデータを操作できるようにする、2000 年代初期からのレガシ .NET Framework テクノロジです。テクノロジが特に役立つのは、ユーザーがデータを変更し、変更をデータベースに戻して保持できるようにするアプリケーションです。データセットは非常に優れたテクノロジであることが証明されていますが、新しい .NET アプリケーションでは Entity Framework Core を使用することをお勧めしています。 Entity Framework には、オブジェクトモデルとして表形式データを操作する、より自然な方法が用意されており、よりシンプルなプログラミングインターフェイスが備わっています。

このチュートリアルでは、データバインドコントロールを含む WPF アプリケーションを作成します。コントロールは、データセットでカプセル化された製品レコードにバインドされます。また、製品を参照するためのボタンの追加と、製品レコードへの変更の保存も行います。

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

WPF アプリケーションと、AdventureWorksLT サンプルデータベースのデータから生成されるデータセットを作成する。
[データソース] ウィンドウから WPF デザイナーのウィンドウにデータテーブルをドラッグして、一連のデータバインドコントロールを作成する。
製品レコード間を前後に移動するためのボタンを作成する。
ユーザーが製品レコードに加えた変更を、データテーブルおよび基になるデータソースに保存するボタンを作成する。

Note

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

必須コンポーネント

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

このチュートリアルを完了するには、Visual Studio にインストールされている .NET デスクトップ開発とデータの保存と処理のワークロードが必要です。これらをインストールするには、Visual Studio インストーラーを開き、変更する Visual Studio のバージョンの横にある [変更] (または [その他]>[変更] ) を選択します。 Visual Studio の変更に関するページを参照してください。
AdventureWorks Light (AdventureWorksLT) サンプルデータベースがアタッチされた、SQL Server または SQL Server Express の実行中のインスタンスへのアクセス権。データベースをダウンロードするには、AdventureWorks サンプルデータベースを参照してください。

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

データセットおよび TableAdapter。詳細については、Visual Studio のデータセットツールおよびTableAdapters に関するページを参照してください。
WPF データバインディング。詳しくは、「データバインディングの概要」をご覧ください。

プロジェクトを作成する

製品レコードを表示する新しい WPF プロジェクトを作成します。

Visual Studio を開きます。
スタートウィンドウで、 [新しいプロジェクトの作成] を選択します。
C# の [WPF アプリケーション] プロジェクトテンプレートを検索し、手順に従ってプロジェクトを作成し、プロジェクトに AdventureWorksProductsEditor という名前を付けます。

Visual Studio によって AdventureWorksProductsEditor プロジェクトが作成されます。

アプリケーション用のデータセットを作成する

データバインドコントロールを作成するには、まず、アプリケーション用のデータモデルを定義し、[データソース] ウィンドウに追加する必要があります。このチュートリアルでは、データモデルとして使用するデータセットを作成します。

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

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

データソース構成ウィザードが開きます。
[データソースの種類の選択] ページで [データベース] を選択した後、[次へ] を選択します。
[データベースモデルの選択] ページで、[データセット] を選択した後、[次へ] を選択します。
[データ接続の選択] ページで、次のいずれかのオプションを選択します。
- AdventureWorksLT サンプルデータベースへのデータ接続がドロップダウンリストに表示されている場合は、それを選択した後、[次へ] を選択します。
- [新しい接続] をクリックして、AdventureWorksLT データベースへの接続を作成します。
[接続文字列をアプリケーション構成ファイルに保存する] ページで、[次の名前で接続を保存する] チェックボックスをオンにし、[次へ] を選択します。
[データベースオブジェクトの選択] ページで、[テーブル] を展開し、Product (SalesLT) テーブルを選択します。
[完了] をクリックします。

Visual Studio によって、新しい AdventureWorksLTDataSet.xsd ファイルがプロジェクトに追加されます。また、対応する AdventureWorksLTDataSet 項目が [データソース] ウィンドウに追加されます。 AdventureWorksLTDataSet.xsd ファイルには、AdventureWorksLTDataSet という名前の型指定されたデータセットと、ProductTableAdapter という名前の TableAdapter が定義されます。このチュートリアルの後半で、ProductTableAdapter を使用してデータセットにデータを読み込み、変更をデータベースに保存します。
プロジェクトをビルドします。

TableAdapter の既定の Fill メソッドを編集する

データセットにデータを読み込むには、Fill の ProductTableAdapter メソッドを使用します。既定では、Fill メソッドによって、ProductDataTable の AdventureWorksLTDataSet に Product テーブルのすべてのデータ行が読み込まれます。このメソッドは、行のサブセットのみを返すように変更できます。このチュートリアルでは、写真付きの製品の行のみを返すように Fill メソッドを変更します。

ソリューションエクスプローラーで、AdventureWorksLTDataSet.xsd ファイルをダブルクリックします。

データセットデザイナーが開きます。
デザイナーで、[Fill, GetData()] クエリを右クリックし、[構成] を選択します。

TableAdapter 構成ウィザードが開きます。
[SQL ステートメントの入力] ページのテキストボックスで、WHERE ステートメントの後に次の SELECT 句を追加します。
```
WHERE ThumbnailPhotoFileName <> 'no_image_available_small.gif'
```
[完了] をクリックします。

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

WPF デザイナーで XAML を変更して、いくつかのボタンをウィンドウに追加します。これらのボタンを使用して製品レコード間をスクロールしたり、製品レコードへの変更を保存したりできるようにするコードは、このチュートリアルで後で追加します。

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

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

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

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

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

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

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

[データソース] ウィンドウで、[Product] ノードのドロップダウンリストメニューをクリックし、[詳細] を選択します。
[Product] ノードを展開します。
この例ではいくつかのフィールドを非表示にするために、次のノードの横のドロップダウンリストメニューをクリックして [なし] を選択します。
- ProductCategoryID
- ProductModelID
- ThumbnailPhotoFileName
- rowguid
- ModifiedDate
[ThumbNailPhoto] ノードの横にあるドロップダウンリストリストメニューをクリックし、[イメージ] を選択します。

Note

既定では、画像を表す [データソース] ウィンドウ内の項目は、既定のコントロールが [なし] に設定されています。これは、画像がデータベース内でバイト配列として格納されているためです。バイト配列には、単純なバイト配列から大規模なアプリケーションの実行可能ファイルまで、あらゆるデータを格納できます。
[データソース] ウィンドウから、ボタンがある行の下のグリッド行に [Product] ノードをドラッグします。

Visual Studio によって、Product テーブルのデータにバインドされるコントロールセットを定義する XAML が生成されます。また、データを読み込むコードも生成されます。生成される XAML およびコードの詳細については、「Visual Studio でデータに WPF コントロールをバインドする」を参照してください。
デザイナーで、[Product ID] ラベルの横のテキストボックスをクリックします。
[プロパティ] ウィンドウで、IsReadOnly プロパティの横のチェックボックスをオンにします。

製品レコードの移動

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

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

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

Window_Loaded イベントハンドラーを変更して、ProductViewSource、AdventureWorksLTDataSet、AdventureWorksLTDataSetProductTableAdapter がメソッドの外部になり、フォーム全体からアクセスできるようにします。次のように、フォームに対してこれらのみをグローバルとして宣言し、Window_Loaded イベントハンドラー内でそれらを割り当てます。

private AdventureWorksProductsEditor.AdventureWorksLTDataSet AdventureWorksLTDataSet;
private AdventureWorksProductsEditor.AdventureWorksLTDataSetTableAdapters.ProductTableAdapter adventureWorksLTDataSetProductTableAdapter;
private System.Windows.Data.CollectionViewSource productViewSource;

private void Window_Loaded(object sender, RoutedEventArgs e)
{
    AdventureWorksLTDataSet = ((AdventureWorksProductsEditor.AdventureWorksLTDataSet)(this.FindResource("adventureWorksLTDataSet")));
    // Load data into the table Product. You can modify this code as needed.
    adventureWorksLTDataSetProductTableAdapter = new AdventureWorksProductsEditor.AdventureWorksLTDataSetTableAdapters.ProductTableAdapter();
    adventureWorksLTDataSetProductTableAdapter.Fill(AdventureWorksLTDataSet.Product);
    productViewSource = ((System.Windows.Data.CollectionViewSource)(this.FindResource("productViewSource")));
    productViewSource.View.MoveCurrentToFirst();
}

Dim ProductViewSource As System.Windows.Data.CollectionViewSource
Dim AdventureWorksLTDataSet As AdventureWorksProductsEditor.AdventureWorksLTDataSet
Dim AdventureWorksLTDataSetProductTableAdapter As AdventureWorksProductsEditor.AdventureWorksLTDataSetTableAdapters.ProductTableAdapter

Private Sub Window_Loaded(ByVal sender As System.Object, ByVal e As System.Windows.RoutedEventArgs) Handles MyBase.Loaded
    AdventureWorksLTDataSet = CType(Me.FindResource("AdventureWorksLTDataSet"), AdventureWorksProductsEditor.AdventureWorksLTDataSet)
    'Load data into the table Product. You can modify this code as needed.
    AdventureWorksLTDataSetProductTableAdapter = New AdventureWorksProductsEditor.AdventureWorksLTDataSetTableAdapters.ProductTableAdapter()
    AdventureWorksLTDataSetProductTableAdapter.Fill(AdventureWorksLTDataSet.Product)
    ProductViewSource = CType(Me.FindResource("ProductViewSource"), System.Windows.Data.CollectionViewSource)
    ProductViewSource.View.MoveCurrentToFirst()
End Sub

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

if (productViewSource.View.CurrentPosition > 0)
{
    productViewSource.View.MoveCurrentToPrevious();
}

If ProductViewSource.View.CurrentPosition > 0 Then
    ProductViewSource.View.MoveCurrentToPrevious()
End If

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

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

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

If ProductViewSource.View.CurrentPosition < CType(ProductViewSource.View, CollectionView).Count - 1 Then
    ProductViewSource.View.MoveCurrentToNext()
End If

製品レコードに変更を保存する

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

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

Visual Studio によって分離コードファイルが開かれ、saveButton_Click イベントのために新しい Click イベントハンドラーが作成されます。
saveButton_Click イベントハンドラーに次のコードを追加します。
- C#
- VB
```
adventureWorksLTDataSetProductTableAdapter.Update(AdventureWorksLTDataSet.Product);
```
```
AdventureWorksLTDataSetProductTableAdapter.Update(AdventureWorksLTDataSet.Product)
```
注意

この例では、Save の TableAdapter メソッドを使用して変更を保存します。このチュートリアルでは、データテーブルが 1 つのみ変更されるため、この方法が適しています。複数のデータテーブルへの変更を保存する必要がある場合は、Visual Studio によってデータセットと共に生成される UpdateAll の TableAdapterManager メソッドを使用することもできます。詳細については、TableAdapter に関するページを参照してください。

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

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

F5キーを押します。

アプリケーションがビルドされ、実行されます。次の点を確認します。
- テキストボックスに、写真付きの製品の先頭のレコードのデータが表示されること。この製品の製品 ID は 713 で、製品名は Long-Sleeve Logo Jersey, S です。
- [>] または []< をクリックして、他の製品レコードに移動できること。
いずれかの製品レコードで [サイズ] の値を変更し、[変更の保存] を選択します。
アプリケーションを終了し、Visual Studio で F5 キーを押してアプリケーションを再起動します。
変更した製品レコードに移動し、変更が保持されていることを確認します。
アプリケーションを終了します。

次のステップ

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

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

次の方法で共有

.NET Framework アプリケーションのデータセットに WPF コントロールをバインドする

必須コンポーネント

プロジェクトを作成する

アプリケーション用のデータセットを作成する

TableAdapter の既定の Fill メソッドを編集する

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

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

製品レコードの移動

製品レコードに変更を保存する

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

次のステップ

フィードバック

その他のリソース

次の方法で共有

.NET Framework アプリケーションのデータセットに WPF コントロールをバインドする

必須コンポーネント

プロジェクトを作成する

アプリケーション用のデータセットを作成する

TableAdapter の既定の Fill メソッドを編集する

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

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

製品レコードの移動

製品レコードに変更を保存する

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

次のステップ

関連するコンテンツ

フィードバック

その他のリソース

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

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