.NET Framework アプリケーションのデータベース (複数のテーブル) にデータを保存する

注

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

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

TableAdapter の Update メソッドを呼び出すことで、アプリケーション内のデータをデータベースに保存し直すことができます。 [ データソース] ウィンドウからフォームにテーブルをドラッグすると、データを保存するために必要なコードが自動的に追加されます。フォームに追加されるテーブルを追加するには、このコードを手動で追加する必要があります。このチュートリアルでは、複数のテーブルから更新を保存するコードを追加する方法について説明します。

このチュートリアルで説明するタスクは次のとおりです。

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

[前提条件]

このチュートリアルを完了するには、Visual Studio にインストールされている .NET デスクトップ開発ワークロードとデータストレージワークロードと処理ワークロードが必要です。インストールするには、Visual Studio インストーラー を開き、変更したい Visual Studio のバージョンの横にある [変更] （または [その他の >変更]）を選択します。 Visual Studio の変更に関するページを参照してください。

このチュートリアルでは、SQL Server Express LocalDB と Northwind サンプルデータベースを使用します。

SQL Server Express LocalDB がない場合は、 SQL Server Express のダウンロードページまたは Visual Studio インストーラーからインストールします。 Visual Studio インストーラーでは、データストレージと処理ワークロードの一部として、または個々のコンポーネントとして SQL Server Express LocalDB をインストールできます。
次の手順に従って Northwind サンプルデータベースをインストールします。
1. Visual Studio で、 SQL Server オブジェクトエクスプローラー ウィンドウを開きます。 (SQL Server オブジェクトエクスプローラーは、Visual Studio インストーラーの データストレージと処理 ワークロードの一部としてインストールされます)。 SQL Server ノードを展開します。 LocalDB インスタンスを右クリックし、[ 新しいクエリ] を選択します。
  
  クエリエディターウィンドウが開きます。
2. Northwind Transact-SQL スクリプトをクリップボードにコピーします。この T-SQL スクリプトは、Northwind データベースを最初から作成し、データを設定します。
3. T-SQL スクリプトをクエリエディターに貼り付け、[ 実行] ボタンを選択します。
  
  しばらくすると、クエリの実行が完了し、Northwind データベースが作成されます。

Windows フォームアプリケーションを作成する

C# または Visual Basic 用の新しい Windows フォームアプリ プロジェクトを作成します。プロジェクトに UpdateMultipleTablesWalkthrough という名前を付けます。

データソースの作成

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

[ データ ] メニューの [ データソースの表示] を選択します。

[ データソース] ウィンドウが開きます。
[ データソース ] ウィンドウで、[ 新しいデータソースの追加 ] を選択して 、データソース構成ウィザードを開始します。
[ データソースの種類の選択 ] 画面で、[ データベース] を選択し、[ 次へ] を選択します。
[ データ接続の選択 ] 画面で、次のいずれかの操作を行います。
- Northwind サンプルデータベースへのデータ接続がドロップダウンリストで使用できる場合は、それを選択します。
  
  -又は-
- [ 新しい接続] を選択して、[ 接続の追加/変更 ] ダイアログボックスを開きます。
データベースにパスワードが必要な場合は、機密データを含めるオプションを選択し、[ 次へ] を選択します。
[ アプリケーション構成ファイルへの接続文字列の保存] で、[ 次へ] を選択します。
[ データベースオブジェクトの選択] 画面で、[ テーブル ] ノードを展開します。
[顧客] テーブルと [注文] テーブルを選択し、[完了] を選択します。

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

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

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

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

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

データバインドフォームを作成する

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

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

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

注

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

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

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

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

注

わかりやすくするために、このチュートリアルではトランザクションを使用しません。ただし、2 つ以上の関連テーブルを更新する場合は、トランザクション内のすべての更新ロジックを含めます。トランザクションは、変更がコミットされる前に、データベースに関連するすべての変更が成功することを保証するプロセスです。詳しくは、「トランザクションとコンカレンシー」をご覧ください。

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

BindingNavigatorの [保存] ボタンを選択します。これにより、コードエディターが開き、 bindingNavigatorSaveItem_Click イベントハンドラーが表示されます。

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

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();
    }
}

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

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

F5キーを押します。
各テーブルの 1 つ以上のレコードのデータにいくつかの変更を加えます。
[保存] ボタンを選択します。
データベース内の値を調べて、変更が保存されたことを確認します。

データをデータベースに保存し直す

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-12-12

次の方法で共有

.NET Framework アプリケーションのデータベース (複数のテーブル) にデータを保存する

[前提条件]

Windows フォーム アプリケーションを作成する

データ ソースの作成

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

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

データ バインド フォームを作成する