チュートリアル : トランザクションのデータの保存

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

このチュートリアルでは、System.Transactions 名前空間を使用してトランザクションのデータを保存する方法を示します。この例では、Northwind サンプルデータベースの Customers テーブルと Orders テーブルを使用します。

前提条件

このチュートリアルには、Northwind サンプルデータベースへのアクセスが必要です。Northwind サンプルデータベースのセットアップの詳細については、「方法 : サンプルデータベースをインストールする」を参照してください。

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

最初に Windows アプリケーションを作成します。

新しい Windows プロジェクトを作成するには

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

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

データベースのデータソースの作成

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

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

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

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

フォームへのコントロールの追加

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

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

[データソース] ウィンドウの [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 イベントに追加されます。追加テーブルを更新する場合は、手動でコードを追加する必要があります。このチュートリアルでは、保存ボタンのイベントハンドラから既存の保存コードをリファクタリングし、行を追加するかまたは削除するかによって、必要な更新機能を提供するメソッドを作成します。

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

CustomersBindingNavigator の [保存] ボタン (フロッピーディスクのアイコンのボタン) をダブルクリックします。

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

Private Sub CustomersBindingNavigatorSaveItem_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    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

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

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

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

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

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

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

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

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

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

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

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

新規顧客を追加するには

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

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

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

新規注文を追加するには

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

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

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

アプリケーションの実行

アプリケーションを実行するには

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

参照

次の方法で共有

チュートリアル : トランザクションのデータの保存

前提条件

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

新しい Windows プロジェクトを作成するには

データベースのデータソースの作成

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

フォームへのコントロールの追加

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

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

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

BindingNavigator の SaveItem ボタンのコードの変更

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

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

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

新規顧客を追加するには

新規注文を追加するには

アプリケーションの実行

アプリケーションを実行するには

参照

処理手順

概念

その他の技術情報

その他のリソース

次の方法で共有

チュートリアル : トランザクションのデータの保存

前提条件

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

新しい Windows プロジェクトを作成するには

データベースのデータ ソースの作成

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

フォームへのコントロールの追加

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

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

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

BindingNavigator の SaveItem ボタンのコードの変更

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

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

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

新規顧客を追加するには

新規注文を追加するには

アプリケーションの実行

アプリケーションを実行するには

参照

処理手順

概念

その他の技術情報

その他のリソース

データベースのデータソースの作成

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

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