チュートリアル : データベースへのデータの保存 (複数テーブル)

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

アプリケーション開発における最も一般的なシナリオの 1 つに、Windows アプリケーションのフォームにデータを表示して編集し、更新したデータをデータベースに返送する操作があります。このチュートリアルでは、2 つの関連するテーブルのデータを表示するフォームを作成し、レコードを編集して変更内容をデータベースに保存する方法を示します。この例では、Northwind サンプルデータベースの Customers テーブルと Orders テーブルを使用します。

アプリケーション内のデータをデータベースに保存するには、TableAdapter の Update メソッドを呼び出します。項目を [データソース] ウィンドウからドラッグすると、データを保存するコードが、フォームにドラッグされた最初のテーブルに自動的に追加されます。さらに別のテーブルをフォームに追加した場合は、データ保存用のコードを手動で追加する必要があります。ここでは、複数のテーブルから更新を保存するコードを追加する手順を示します。

[!メモ]

実際に画面に表示されるダイアログボックスとメニューコマンドは、アクティブな設定またはエディションによっては、ヘルプの説明と異なる場合があります。設定を変更するには、[ツール] メニューの [設定のインポートとエクスポート] をクリックします。詳細については、「Visual Studio の設定」を参照してください。

このチュートリアルでは、以下のタスクを行います。

新しい Windows アプリケーション プロジェクトを作成します。
データソース構成ウィザードを使用して、アプリケーションにデータソースを作成して構成します。
[データソース] ウィンドウで、項目のコントロールを設定します。詳細については、「方法 : [データソース] ウィンドウからドラッグしたときに作成されるコントロールを設定する」を参照してください。
[データソース] ウィンドウからフォームに項目をドラッグして、データバインドコントロールを作成します。
データセットの各テーブルのいくつかのレコードを変更します。
データセット内の更新されたデータをデータベースに返送するコードを変更します。

必須コンポーネント

このチュートリアルを完了するための要件は次のとおりです。

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

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

最初に Windows アプリケーションを作成します。この手順ではプロジェクトへの名前の割り当てはオプションですが、後でこのプロジェクトを保存するため、プロジェクトに名前を付けます。

新しい Windows アプリケーションプロジェクトを作成するには

[ファイル] メニューで新しいプロジェクトを作成します。
プロジェクトに UpdateMultipleTablesWalkthrough という名前を付けます。
[Windows アプリケーション] をクリックし、[OK] をクリックします。詳細については、「クライアントアプリケーションの開発」を参照してください。

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

データソースの作成

この手順では、データソース構成ウィザードを使用して、Northwind データベースからデータソースを作成します。接続を作成するには、Northwind サンプルデータベースにアクセスできる必要があります。Northwind サンプルデータベースのセットアップの詳細については、「方法 : サンプルデータベースをインストールする」を参照してください。

データソースを作成するには

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

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

作成するコントロールの設定

このチュートリアルでは、データが個別のコントロールに表示される詳細レイアウトで、Customers テーブル内のデータを表示します。Orders テーブルのデータは、DataGridView コントロール内に表示される グリッド レイアウトで表示します。

[データソース] ウィンドウの項目のドロップタイプを設定するには

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

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

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

フォームにデータバインディングコントロールを作成するには

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

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

[!メモ]

関連する [Orders] ノードは [Fax] 列の下にあり、[Customers] ノードの子ノードです。

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

データベースを更新するコードの追加

Customers TableAdapter および Orders TableAdapter の Update メソッドを呼び出して、データベースを更新できます。既定では、BindingNavigator の [データの保存] ボタンのイベントハンドラーが、データベースに更新を送信するフォームのコードに追加されます。この手順では、正しい順序で更新を送信し、参照整合性エラーが発生する可能性がなくなるようにコードを変更します。また、Update 呼び出しを try-catch ブロックにラップして、エラー処理も実装します。アプリケーションの要件に適合するようにコードを変更できます。

[!メモ]

説明をわかりやすくするために、ここではトランザクションを使用していませんが、関連する複数のテーブルを更新する場合は、すべての更新ロジックを 1 つのトランザクションに含める必要があります。トランザクションは、変更をコミットする前に、関連するすべての変更を正しくデータベースに反映できることを確認するプロセスです。詳細については、「Performing Transactions」を参照してください。

アプリケーションに更新ロジックを追加するには

BindingNavigator の [データの保存] ボタンをダブルクリックして、コードエディターで bindingNavigatorSaveItem_Click イベントハンドラーを開きます。

イベントハンドラーのコードを、関連する TableAdapter の Update メソッドを呼び出すコードに置き換えます。次のコードは、最初に、各 DataRowState (Deleted、Added、および Modified) の更新済み情報を保持する 3 つの一時的なデータテーブルを作成します。次に、正しい順序で更新を実行します。コードは、次のようになります。

Me.Validate()
Me.OrdersBindingSource.EndEdit()
Me.CustomersBindingSource.EndEdit()

Dim deletedOrders As NorthwindDataSet.OrdersDataTable = CType(
    NorthwindDataSet.Orders.GetChanges(Data.DataRowState.Deleted), NorthwindDataSet.OrdersDataTable)

Dim newOrders As NorthwindDataSet.OrdersDataTable = CType(
    NorthwindDataSet.Orders.GetChanges(Data.DataRowState.Added), NorthwindDataSet.OrdersDataTable)

Dim modifiedOrders As NorthwindDataSet.OrdersDataTable = CType(
    NorthwindDataSet.Orders.GetChanges(Data.DataRowState.Modified), NorthwindDataSet.OrdersDataTable)


Try
    ' Remove all deleted orders from the Orders table.
    If Not deletedOrders Is Nothing Then
        OrdersTableAdapter.Update(deletedOrders)
    End If

    ' Update the Customers table.
    CustomersTableAdapter.Update(NorthwindDataSet.Customers)

    ' Add new orders to the Orders table.
    If Not newOrders Is Nothing Then
        OrdersTableAdapter.Update(newOrders)
    End If

    ' Update all modified Orders.
    If Not modifiedOrders Is Nothing Then
        OrdersTableAdapter.Update(modifiedOrders)
    End If

    NorthwindDataSet.AcceptChanges()

Catch ex As Exception
    MsgBox("Update failed")

Finally
    If Not deletedOrders Is Nothing Then
        deletedOrders.Dispose()
    End If

    If Not newOrders Is Nothing Then
        newOrders.Dispose()
    End If

    If Not modifiedOrders Is Nothing Then
        modifiedOrders.Dispose()
    End If
End Try

this.Validate();
this.ordersBindingSource.EndEdit();
this.customersBindingSource.EndEdit();

NorthwindDataSet.OrdersDataTable deletedOrders = (NorthwindDataSet.OrdersDataTable)
    northwindDataSet.Orders.GetChanges(DataRowState.Deleted);

NorthwindDataSet.OrdersDataTable newOrders = (NorthwindDataSet.OrdersDataTable)
    northwindDataSet.Orders.GetChanges(DataRowState.Added);

NorthwindDataSet.OrdersDataTable modifiedOrders = (NorthwindDataSet.OrdersDataTable)
    northwindDataSet.Orders.GetChanges(DataRowState.Modified);

try
{
    // Remove all deleted orders from the Orders table.
    if (deletedOrders != null)
    {
        ordersTableAdapter.Update(deletedOrders);
    }

    // Update the Customers table.
    customersTableAdapter.Update(northwindDataSet.Customers);

    // Add new orders to the Orders table.
    if (newOrders != null)
    {
        ordersTableAdapter.Update(newOrders);
    }

    // Update all modified Orders.
    if (modifiedOrders != null)
    {
        ordersTableAdapter.Update(modifiedOrders);
    }

    northwindDataSet.AcceptChanges();
}

catch (System.Exception ex)
{
    MessageBox.Show("Update failed");
}

finally
{
    if (deletedOrders != null)
    {
        deletedOrders.Dispose();
    }
    if (newOrders != null)
    {
        newOrders.Dispose();
    }
    if (modifiedOrders != null)
    {
        modifiedOrders.Dispose();
    }
}