チュートリアル : 関連するデータテーブルからのデータの保存 (階層更新)

[アーティクル]
02/21/2013

アプリケーション上のデータをデータベースに保存し直すのは、データのテーブルが 1 つだけの場合や、外部キー制約を考慮する必要がない場合は非常に簡単です。しかし、複数のデータテーブルが関連し合うデータセットからデータを保存する場合は、制約に違反しない順番で変更内容をデータベースに送信する必要があります。関連テーブルで変更したデータを更新するには、各データテーブルからデータのサブセットを抽出し、正しい順番でデータベースに更新を送信するプログラムロジックを用意します。または、TableAdapterManager コンポーネントを使用するという方法もあります。

このチュートリアルでは、TableAdapterManager コンポーネントを使用して関連データを保存する方法について説明します。手動による関連データテーブル更新のコーディングについては、「チュートリアル : データベースへのデータの保存 (複数テーブル)」を参照してください。

必須コンポーネント

このチュートリアルを完了するには、次の条件が必要です。

Northwind サンプルデータベースにアクセスします。詳細については、「方法 : サンプルデータベースをインストールする」を参照してください。

Windows ベースアプリケーションの作成

このチュートリアルでは、まず、新しい Windows ベースのアプリケーションを作成します。

新しい Windows ベースのアプリケーションを作成するには

[ファイル] メニューで新しいプロジェクトを作成します。

[!メモ]

階層更新は、Visual Basic プロジェクトと C# プロジェクトでサポートされる機能です。新しいプロジェクトはこのどちらかの言語で作成してください。
プロジェクトに HierarchicalUpdateWalkthrough という名前を付けます。
[Windows フォームアプリケーション] をクリックし、[OK] をクリックします。詳細については、「クライアントアプリケーションの開発」を参照してください。

HierarchicalUpdateWalkthrough プロジェクトが作成されてソリューションエクスプローラーに追加されます。

データセットの作成

階層更新を実行するには関連テーブルが必要なので、次に、Northwind データベースの Customers テーブルと Orders テーブルを含むデータセットを作成します。データソース構成ウィザードを実行して、データセットを作成します。接続を作成するには、Northwind サンプルデータベースにアクセスできる必要があります。Northwind サンプルデータベースの設定方法については、「方法 : サンプルデータベースをインストールする」を参照してください。

データセットを作成するには

[データ] メニューの [データソースの表示] をクリックします。
[データソース] ウィンドウで、[新しいデータソースの追加] をクリックしてデータソース構成ウィザードを起動します。
[データソースの種類を選択] ページで、[データベース] をクリックし、[次へ] をクリックします。
[データ接続の選択] ページで、次のいずれかの操作を行います。
- Northwind サンプルデータベースへのデータ接続がドロップダウンリストボックスに表示されている場合は、これをクリックします。
  
  または
- [新しい接続] をクリックして [接続の追加] または [接続の変更] ダイアログボックスを表示します。詳細については、「[接続の追加] ダイアログボックスと [接続の変更] ダイアログボックス (一般)」を参照してください。
データベースにパスワードが必要な場合は、該当するオプションを選択して重要情報を含め、[次へ] をクリックします。
[アプリケーション構成ファイルに接続文字列を保存] ページで、[次へ] をクリックします。
[データベースオブジェクトの選択] ページの [テーブル] ノードを展開します。
Customers テーブルと Orders テーブルに該当するチェックボックスをオンにし、[完了] をクリックします。

プロジェクトに NorthwindDataSet が追加され、[データソース] ウィンドウにこれら 2 つのテーブルが表示されます。

作成される既定のデータバインドコントロールの変更

[データソース] ウィンドウでデータソースを設定したら、次に、Windows フォームに項目をドラッグしたときに作成されるコントロールを選択します。このチュートリアルでは、Customers テーブルのデータを個別のコントロール ([詳細]) で表示します。Orders テーブルのデータは、DataGridView コントロール (DataGridView) に表示します。

[データソース] ウィンドウの項目に対してコントロールを設定するには

[データソース] ウィンドウの [Customers] ノードを展開します。
[Customers] ノードのコントロールリストで [詳細] をクリックし、Customers テーブルに対して作成されるコントロールを個別のコントロールに変更します。詳細については、「方法 : [データソース] ウィンドウからドラッグしたときに作成されるコントロールを設定する」を参照してください。

[!メモ]

Orders テーブルは、既定のコントロール DataGridView を使用します。

データバインドフォームの作成

[データソース] ウィンドウでコントロールを選択したら、フォームに項目をドラッグして、データバインドコントロールを作成します。

Customers データと Orders データのデータバインドコントロールを作成するには

[データソース] ウィンドウから Form1 にメインの [Customers] ノードをドラッグします。

説明のラベルが付いたデータバインドコントロールが、レコード間を移動するためのツールバー (BindingNavigator) である TableAdapterManager コンポーネントと共にフォーム上に表示されます。型指定された DataSet、TableAdapter、および BindingSource がコンポーネントトレイに表示されます。
[データソース] ウィンドウから Form1 に [Orders] ノードをドラッグします。

[!メモ]

関連する [Orders] ノードは Customers テーブルの [Fax] ノードの下にあり、[Customers] ノードの子ノードです。[Customers] ノードのピアとして表示される [Orders] ノードは、Orders テーブル内のすべての注文を表します。[Customers] ノードの子ノードとして表示される [Orders] ノードは、関連する注文を表します。

DataGridView とレコード間をナビゲートするためのツールバー (BindingNavigator) がフォームに表示されます。コンポーネントトレイには TableAdapter と BindingSource が表示されます。

階層更新を実行するように生成された保存コードの変更

データセットでの関連データテーブルへの変更をデータベースに保存するには、TableAdapterManager.UpdateAll メソッドを呼び出し、関連テーブルが含まれるデータセットの名前を渡します。たとえば、NorthwindDataset 内の全テーブルの更新をバックエンドのデータベースに送信するには、TableAdapterManager.UpdateAll(NorthwindDataset) メソッドを実行します。

[データソース] ウィンドウから項目をドラッグすると、各テーブルを読み込むコード (TableAdapter.Fill メソッド) が、Form_Load イベントに自動的に追加されます。また、BindingNavigator の [保存] ボタンクリックイベントにも、データセットのデータをデータベースに保存するコード (TableAdapterManager.UpdateAll メソッド) が追加されます。

生成された保存コードには、CustomersBindingSource.EndEdit メソッドを呼び出すコード行も含まれています。これは、具体的には、フォームに最初に追加された BindingSource の EndEdit メソッドを呼び出します。つまり、このコードは [データソース] ウィンドウからフォームに最初にドラッグしたテーブルに対してのみ生成されます。EndEdit 呼び出しは、現在編集中のデータバインドコントロールで実行されている変更をコミットします。したがって、あるデータバインドコントロールにフォーカスがある状態で、[保存] ボタンをクリックすると、実際の保存 (TableAdapterManager.UpdateAll メソッド) が実行される前に、そのコントロール内のすべての保留中の編集がコミットされます。

[!メモ]

デザイナーは、フォームに最初にドロップされたテーブルに対してのみ BindingSource.EndEdit コードを追加します。したがって、フォーム上の各関連テーブルに対しては BindingSource.EndEdit メソッドを呼び出すコードを手動で追加する必要があります。つまり、このチュートリアルでも、OrdersBindingSource.EndEdit メソッドの呼び出しを追加する必要があります。

保存前に、関連テーブルへの変更をコミットするコードを更新するには

BindingNavigator の [保存] ボタンをダブルクリックし、コードエディターに Form1 を開きます。

CustomersBindingSource.EndEdit メソッドを呼び出す行の後に、OrdersBindingSource.EndEdit メソッドを呼び出すコード行を追加します。[保存] ボタンクリックイベント内のコードは、次のようになります。

Me.Validate()
Me.CustomersBindingSource.EndEdit()
Me.OrdersBindingSource.EndEdit()
Me.TableAdapterManager.UpdateAll(Me.NorthwindDataSet)

this.Validate();
this.customersBindingSource.EndEdit();
this.ordersBindingSource.EndEdit();
this.tableAdapterManager.UpdateAll(this.northwindDataSet);

データをデータベースに保存する前に関連子テーブルに対する変更をコミットするだけではなく、新しい子レコードをデータセットに追加する前に、新しく作成された親レコードをコミットすることが必要な場合もあります。つまり、外部キー制約により、新しい子レコード (Orders) をデータセットに追加する前に、データセットに新しい親レコード (Customer) を追加することが必要な場合もあります。この操作を行うには、子 BindingSource.AddingNew イベントを使用します。

[!メモ]

新しい親レコードをコミットする必要があるかどうかは、データソースのバインドに使用されるコントロールの種類によって決定されます。このチュートリアルでは、親テーブルとのバインドに個別のコントロールを使用するので、新しい親レコードをコミットするコードを追加する必要があります。親レコードが DataGridView のような複雑なバインドコントロールに表示される場合には、親レコードに対する EndEdit 呼び出しは必要ありません。これは、コントロールの基になるデータバインド機能が、新しいレコードのコミットを行うためです。

データセットで新しい子レコードを追加する前に親レコードをコミットするコードを追加するには

OrdersBindingSource.AddingNew イベントのイベントハンドラーを作成します。
- デザインビューで Form1 を開いて、コンポーネントトレイの OrdersBindingSource をクリックし、[プロパティ] ウィンドウで [イベント] を選択して、AddingNew イベントをダブルクリックします。
CustomersBindingSource.EndEdit メソッドを呼び出すコード行をイベントハンドラーに追加します。OrdersBindingSource_AddingNew イベントハンドラー内のコードは、次のようになります。
```
Me.CustomersBindingSource.EndEdit()
```
```
this.customersBindingSource.EndEdit();
```

階層更新の有効性の確認

階層更新は、データセットの "階層更新" プロパティを設定することにより、有効または無効にできます。階層更新は、既定で有効になっているため、このチュートリアルで、"階層更新" プロパティ値を変更する必要はありません。

階層更新が有効かどうかを確認するには

ソリューションエクスプローラーで NorthwindDataSet.xsd ファイルをダブルクリックして、データセットデザイナーにこのデータセットを開きます。
デザインサーフェイス上の空の領域を選択します。
[プロパティ] ウィンドウで "階層更新" プロパティを見つけ、これが True に設定されているかどうかを確認します。

[!メモ]

"階層更新" プロパティは、TableAdapterManager と、階層更新を実行するロジックでコードを生成するかどうかを制御します。階層更新を True に設定すると、TableAdapterManager が生成され、"階層更新" を False に設定すると、TableAdapterManager は生成されません。

アプリケーションのテスト

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

F5 キーを押します。
各テーブルの 1 つ以上のレコードのデータを変更します。
新しい顧客を追加し、次に、この顧客に対して新しい注文を追加します。
[データの保存] をクリックします。TableAdapterManager が、関連する更新すべてに必要なロジックを処理します。
データベースの値をチェックし、変更が各テーブルに保存されたことを確認します。

次の手順

Windows ベースアプリケーションに関連データを保存した後で、アプリケーションの要件によってはさらに操作を追加する必要があります。このアプリケーションで行うことができる拡張には次のものがあります。

3 番目のテーブル (OrderDetails テーブルなど) を追加し、3 番目のテーブル階層を試してみる。
データベース制約に加えて、データがアプリケーション要件を満たしているかどうかを検証する検証コードを追加する。詳細については、「データの検証」を参照してください。

参照

チュートリアル : 関連するデータ テーブルからのデータの保存 (階層更新)

必須コンポーネント

Windows ベース アプリケーションの作成