チュートリアル: .NET Framework アプリケーションでトランザクションにデータを保存する

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

Note

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

このチュートリアルでは、System.Transactions 名前空間を使用してトランザクションにデータを保存する方法について説明します。このチュートリアルでは、Windows フォームアプリケーションを作成します。データソース構成ウィザードを使用して、Northwind サンプルデータベースに 2 つのテーブルのデータセットを作成します。データバインドコントロールを Windows フォームに追加し、BindingNavigator の [保存] ボタンのコードを変更して、TransactionScope 内のデータベースを更新します。

前提条件

このチュートリアルを完了するには、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 インストーラーで、 .NET デスクトップ開発ワークロードの一部として、または個別のコンポーネントとして、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 フォームアプリケーションを作成する

最初の手順は、Windows フォームアプリ (.NET Framework) を作成することです。

Visual Studio の [ファイル] メニューで､ [新規作成]>[プロジェクト] を選択します。
左側のペインで [Visual C#] または [Visual Basic] を展開し、 [Windows デスクトップ] を選択します。
中央のペインで、 [Windows フォームアプリ] プロジェクトタイプを選択します。
プロジェクトに SavingDataInATransactionWalkthrough という名前を付け、 [OK] を選択します。

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

データベースのデータソースを作成する

この手順では、データソース構成ウィザードを使用して、Northwind サンプルデータベースの Customers テーブルと Orders テーブルに基づいてデータソースを作成します。

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

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

コントロールをフォームに追加する

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

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

レコード間をナビゲートするための DataGridView コントロールとツールストリップ (BindingNavigator) がフォームに表示されます。コンポーネントトレイには、NorthwindDataSet、CustomersTableAdapter、BindingSource、BindingNavigator が表示されます。
対応する [Orders] ノード (メインの [Orders] ノードではなく、 [Fax] 列の下の対応する子テーブルノード) を CustomersDataGridView の下のフォームにドラッグします。

DataGridView がフォームに表示されます。 OrdersTableAdapter と BindingSource がコンポーネントトレイに表示されます。

System.Transactions アセンブリへの参照を追加する

トランザクションは、System.Transactions 名前空間を使用します。 System.Transactions アセンブリへのプロジェクト参照は既定で追加されないため、手動で追加する必要があります。

System.Transactions の DLL ファイルへの参照を追加するには

[プロジェクト] メニューの [参照の追加] を選択します。
[.NET] タブで System.Transactions を選択し、[OK] を選択します。

System.Transactions への参照がプロジェクトに追加されます。

BindingNavigator の SaveItem ボタンのコードを変更する

既定では、フォームに最初にドロップされるテーブルのコードは、BindingNavigator の保存ボタンの click イベントに追加されます。追加テーブルを更新する場合は、手動でコードを追加する必要があります。このチュートリアルでは、[保存] ボタンのクリックイベントハンドラーから既存の保存コードをリファクタリングします。また、行を追加または削除する必要があるかどうかに基づいて、特定の更新機能を提供するためのメソッドもいくつか作成します。

自動生成された保存コードを変更するには

CustomerBindingNavigator の [保存] ボタン (フロッピーディスクのアイコンのボタン) を選択します。

CustomersBindingNavigatorSaveItem_Click メソッドを次のコードで置き換えます。

private void customersBindingNavigatorSaveItem_Click(object sender, EventArgs e)
{
    UpdateData();
}

private void UpdateData()
{
    this.Validate();
    this.customersBindingSource.EndEdit();
    this.ordersBindingSource.EndEdit();

    using (System.Transactions.TransactionScope updateTransaction = 
        new System.Transactions.TransactionScope())
    {
        DeleteOrders();
        DeleteCustomers();
        AddNewCustomers();
        AddNewOrders();

        updateTransaction.Complete();
        northwindDataSet.AcceptChanges();
    }
}

Private Sub CustomersBindingNavigatorSaveItem_Click() Handles CustomersBindingNavigatorSaveItem.Click
    UpdateData()
End Sub

Private Sub UpdateData()
    Me.Validate()
    Me.CustomersBindingSource.EndEdit()
    Me.OrdersBindingSource.EndEdit()

    Using updateTransaction As New Transactions.TransactionScope

        DeleteOrders()
        DeleteCustomers()
        AddNewCustomers()
        AddNewOrders()

        updateTransaction.Complete()
        NorthwindDataSet.AcceptChanges()
    End Using
End Sub

関連するデータへの変更を解決する順序は次のとおりです。

子レコードを削除します (この場合は、Orders テーブルからレコードを削除します)。
親レコードを削除します (この場合は、Customers テーブルからレコードを削除します)。
親レコードを挿入します (この場合は、Customers テーブルにレコードを挿入します)。
子レコードを挿入します (この場合は、Orders テーブルにレコードを挿入します)。

既存の注文を削除するには

次の DeleteOrders メソッドを Form1 に追加します。

private void DeleteOrders()
{
    NorthwindDataSet.OrdersDataTable deletedOrders;
    deletedOrders = (NorthwindDataSet.OrdersDataTable)
        northwindDataSet.Orders.GetChanges(DataRowState.Deleted);

    if (deletedOrders != null)
    {
        try
        {
            ordersTableAdapter.Update(deletedOrders);
        }
        catch (System.Exception ex)
        {
            MessageBox.Show("DeleteOrders Failed");
        }
    }
}

Private Sub DeleteOrders()

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

    If Not IsNothing(deletedOrders) Then
        Try
            OrdersTableAdapter.Update(deletedOrders)

        Catch ex As Exception
            MessageBox.Show("DeleteOrders Failed")
        End Try
    End If
End Sub

既存の顧客を削除するには

次の DeleteCustomers メソッドを Form1 に追加します。

private void DeleteCustomers()
{
    NorthwindDataSet.CustomersDataTable deletedCustomers;
    deletedCustomers = (NorthwindDataSet.CustomersDataTable)
        northwindDataSet.Customers.GetChanges(DataRowState.Deleted);

    if (deletedCustomers != null)
    {
        try
        {
            customersTableAdapter.Update(deletedCustomers);
        }
        catch (System.Exception ex)
        {
            MessageBox.Show("DeleteCustomers Failed");
        }
    }
}

Private Sub DeleteCustomers()

    Dim deletedCustomers As NorthwindDataSet.CustomersDataTable
    deletedCustomers = CType(NorthwindDataSet.Customers.GetChanges(Data.DataRowState.Deleted),
        NorthwindDataSet.CustomersDataTable)

    If Not IsNothing(deletedCustomers) Then
        Try
            CustomersTableAdapter.Update(deletedCustomers)

        Catch ex As Exception
            MessageBox.Show("DeleteCustomers Failed" & vbCrLf & ex.Message)
        End Try
    End If
End Sub

新規顧客を追加するには

次の AddNewCustomers メソッドを Form1 に追加します。

private void AddNewCustomers()
{
    NorthwindDataSet.CustomersDataTable newCustomers;
    newCustomers = (NorthwindDataSet.CustomersDataTable)
        northwindDataSet.Customers.GetChanges(DataRowState.Added);

    if (newCustomers != null)
    {
        try
        {
            customersTableAdapter.Update(newCustomers);
        }
        catch (System.Exception ex)
        {
            MessageBox.Show("AddNewCustomers Failed");
        }
    }
}

Private Sub AddNewCustomers()

    Dim newCustomers As NorthwindDataSet.CustomersDataTable
    newCustomers = CType(NorthwindDataSet.Customers.GetChanges(Data.DataRowState.Added),
        NorthwindDataSet.CustomersDataTable)

    If Not IsNothing(newCustomers) Then
        Try
            CustomersTableAdapter.Update(newCustomers)

        Catch ex As Exception
            MessageBox.Show("AddNewCustomers Failed" & vbCrLf & ex.Message)
        End Try
    End If
End Sub

新規注文を追加するには

次の AddNewOrders メソッドを Form1 に追加します。

private void AddNewOrders()
{
    NorthwindDataSet.OrdersDataTable newOrders;
    newOrders = (NorthwindDataSet.OrdersDataTable)
        northwindDataSet.Orders.GetChanges(DataRowState.Added);

    if (newOrders != null)
    {
        try
        {
            ordersTableAdapter.Update(newOrders);
        }
        catch (System.Exception ex)
        {
            MessageBox.Show("AddNewOrders Failed");
        }
    }
}

Private Sub AddNewOrders()

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

    If Not IsNothing(newOrders) Then
        Try
            OrdersTableAdapter.Update(newOrders)

        Catch ex As Exception
            MessageBox.Show("AddNewOrders Failed" & vbCrLf & ex.Message)
        End Try
    End If
End Sub

アプリケーションの実行

F5 キーを押してアプリケーションを実行します。

次の方法で共有

チュートリアル: .NET Framework アプリケーションでトランザクションにデータを保存する

前提条件

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

データベースのデータソースを作成する

コントロールをフォームに追加する

System.Transactions アセンブリへの参照を追加する

System.Transactions の DLL ファイルへの参照を追加するには

BindingNavigator の SaveItem ボタンのコードを変更する

自動生成された保存コードを変更するには

既存の注文を削除するには

既存の顧客を削除するには

新規顧客を追加するには

新規注文を追加するには

アプリケーションの実行

フィードバック

その他のリソース

次の方法で共有

チュートリアル: .NET Framework アプリケーションでトランザクションにデータを保存する

前提条件

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

データベースのデータ ソースを作成する

コントロールをフォームに追加する

System.Transactions アセンブリへの参照を追加する

System.Transactions の DLL ファイルへの参照を追加するには

BindingNavigator の SaveItem ボタンのコードを変更する

自動生成された保存コードを変更するには

既存の注文を削除するには

既存の顧客を削除するには

新規顧客を追加するには

新規注文を追加するには

アプリケーションの実行

関連するコンテンツ

フィードバック

その他のリソース

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

データベースのデータソースを作成する