TransactionScope クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

TransactionScope クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

コードブロックをトランザクションにします。このクラスは継承できません。

名前空間: System.Transactions
アセンブリ: System.Transactions (system.transactions.dll 内)
構文

Visual Basic (宣言)

Public NotInheritable Class
 TransactionScope
    Implements IDisposable

Visual Basic (使用法)

Dim instance As TransactionScope

public sealed class TransactionScope : IDisposable

C++

public ref class TransactionScope sealed :
 IDisposable

public final class TransactionScope implements
 IDisposable

JScript

public final class TransactionScope implements
 IDisposable

解説

System.Transactions インフラストラクチャは、Transaction クラスに基づく明示的なプログラミングモデルだけでなく、インフラストラクチャがトランザクションを自動的に管理する、TransactionScope クラスを使用した暗黙のプログラミングモデルも提供します。

重要 :
TransactionScope クラスを使用して暗黙のトランザクションを作成し、アンビエントトランザクションコンテキストを自動的に管理することをお勧めします。複数の関数呼び出しまたは複数のスレッド呼び出しで同じトランザクションを使用する必要のあるアプリケーション向けに、TransactionScope クラスおよび DependentTransaction クラスを使用する必要もあります。このモデルの詳細については、「トランザクションスコープを使用した暗黙的なトランザクションの実装」を参照してください。トランザクションアプリケーションの記述の詳細については、「トランザクションアプリケーションの作成」を参照してください。

重要 :

TransactionScope クラスを使用して暗黙のトランザクションを作成し、アンビエントトランザクションコンテキストを自動的に管理することをお勧めします。複数の関数呼び出しまたは複数のスレッド呼び出しで同じトランザクションを使用する必要のあるアプリケーション向けに、TransactionScope クラスおよび DependentTransaction クラスを使用する必要もあります。このモデルの詳細については、「トランザクションスコープを使用した暗黙的なトランザクションの実装」を参照してください。トランザクションアプリケーションの記述の詳細については、「トランザクションアプリケーションの作成」を参照してください。

トランザクションスコープ内 (つまり、TransactionScope オブジェクトの初期化からその Dispose メソッドの呼び出しまでの間) で例外が発生しなかった場合、スコープが参加しているトランザクションを続行できます。トランザクションスコープ内で例外が発生した場合、スコープが参加しているトランザクションはロールバックされます。

アプリケーションがトランザクション内で実行する必要のあるすべての作業を完了したら、トランザクションマネージャにトランザクションをコミットできることを知らせるために、Complete メソッドを一度だけ呼び出す必要があります。このメソッドを呼び出さないと、トランザクションが中止されます。

Dispose メソッドの呼び出しによって、トランザクションスコープの末尾がマークされます。このメソッドの呼び出し後に発生した例外は、トランザクションに影響しない場合があります。

スコープ内で Current の値を変更すると、Dispose を呼び出したときに例外がスローされます。ただし、スコープの末尾では以前の値が復元されます。また、トランザクションを作成したトランザクションスコープ内のCurrent で Dispose を呼び出した場合、このトランザクションはスコープの末尾で中止されます。

使用例

次の例では、TransactionScope クラスを使用してトランザクションに参加するコードブロックを定義する方法を示します。

Visual Basic

'  This function takes arguments for 2 connection strings and commands
 to create a transaction 
'  involving two SQL Servers. It returns a value > 0 if the transaction
 is committed, 0 if the 
'  transaction is rolled back. To test this code, you can connect to
 two different databases 
'  on the same server by altering the connection string, or to another
 RDBMS such as Oracle 
'  by altering the code in the connection2 code block.
Public Function CreateTransactionScope( _
  ByVal connectString1 As String,
 ByVal connectString2 As String,
 _
  ByVal commandText1 As String,
 ByVal commandText2 As String)
 As Integer

    ' Initialize the return value to zero and create a StringWriter
 to display results.
    Dim returnValue As Integer
 = 0
    Dim writer As System.IO.StringWriter =
 New System.IO.StringWriter

    ' Create the TransactionScope to execute the commands, guaranteeing
    '  that both commands can commit or roll back as a single unit of
 work.
    Using scope As New TransactionScope()
        Using connection1 As New SqlConnection(connectString1)
            Try
                ' Opening the connection automatically enlists it in
 the 
                ' TransactionScope as a lightweight transaction.
                connection1.Open()

                ' Create the SqlCommand object and execute the first
 command.
                Dim command1 As SqlCommand
 = New SqlCommand(commandText1, connection1)
                returnValue = command1.ExecuteNonQuery()
                writer.WriteLine("Rows to be affected by command1:
 {0}", returnValue)

                ' If you get here, this means that command1 succeeded.
 By nesting
                ' the using block for connection2 inside that of connection1,
 you
                ' conserve server and network resources as connection2
 is opened
                ' only when there is a chance that the transaction can
 commit.   
                 Using connection2 As New SqlConnection(connectString2)
                    Try
                        ' The transaction is escalated to a full distributed
                        ' transaction when connection2 is opened.
                        connection2.Open()

                        ' Execute the second command in the second database.
                        returnValue = 0
                        Dim command2 As SqlCommand
 = New SqlCommand(commandText2, connection2)
                        returnValue = command2.ExecuteNonQuery()
                        writer.WriteLine("Rows to be affected
 by command2: {0}", returnValue)

                    Catch ex As Exception
                        ' Display information that command2 failed.
                        writer.WriteLine("returnValue for command2:
 {0}", returnValue)
                        writer.WriteLine("Exception Message2:
 {0}", ex.Message)
                    End Try
                End Using

            Catch ex As Exception
                ' Display information that command1 failed.
                writer.WriteLine("returnValue for command1: {0}",
 returnValue)
                writer.WriteLine("Exception Message1: {0}",
 ex.Message)
            End Try
        End Using

        ' The Complete method commits the transaction. If an exception
 has been thrown,
        ' Complete is called and the transaction is rolled back.
        scope.Complete()
    End Using

    ' The returnValue is greater than 0 if the transaction committed.
    If returnValue > 0 Then
        writer.WriteLine("Transaction was committed.")
    Else
       ' You could write additional business logic here, for example,
 you can notify the caller 
       ' by throwing a TransactionAbortedException, or logging the failure.
       writer.WriteLine("Transaction rolled back.")
     End If

    ' Display messages.
    Console.WriteLine(writer.ToString())

    Return returnValue
End Function

// This function takes arguments for 2 connection strings and commands
 to create a transaction 
// involving two SQL Servers. It returns a value > 0 if the transaction
 is committed, 0 if the 
// transaction is rolled back. To test this code, you can connect to
 two different databases 
// on the same server by altering the connection string, or to another
 RDBMS such as Oracle 
// by altering the code in the connection2 code block.
static public int CreateTransactionScope(
    string connectString1, string connectString2
,
    string commandText1, string commandText2)
{
    // Initialize the return value to zero and create a StringWriter
 to display results.
    int returnValue = 0;
    System.IO.StringWriter writer = new System.IO.StringWriter();

    // Create the TransactionScope to execute the commands, guaranteeing
    // that both commands can commit or roll back as a single unit of
 work.
    using (TransactionScope scope = new TransactionScope())
    {
        using (SqlConnection connection1 = new
 SqlConnection(connectString1))
        {
            try
            {
                // Opening the connection automatically enlists it in
 the 
                // TransactionScope as a lightweight transaction.
                connection1.Open();

                // Create the SqlCommand object and execute the first
 command.
                SqlCommand command1 = new SqlCommand(commandText1,
 connection1);
                returnValue = command1.ExecuteNonQuery();
                writer.WriteLine("Rows to be affected by command1: {0}",
 returnValue);

                // If you get here, this means that command1 succeeded.
 By nesting
                // the using block for connection2 inside that of connection1,
 you
                // conserve server and network resources as connection2
 is opened
                // only when there is a chance that the transaction
 can commit.   
                using (SqlConnection connection2 = new
 SqlConnection(connectString2))
                    try
                    {
                        // The transaction is escalated to a full distributed
                        // transaction when connection2 is opened.
                        connection2.Open();

                        // Execute the second command in the second
 database.
                        returnValue = 0;
                        SqlCommand command2 = new SqlCommand(commandText2,
 connection2);
                        returnValue = command2.ExecuteNonQuery();
                        writer.WriteLine("Rows to be affected by command2: {0}",
 returnValue);
                    }
                    catch (Exception ex)
                    {
                        // Display information that command2 failed.
                        writer.WriteLine("returnValue for
 command2: {0}", returnValue);
                        writer.WriteLine("Exception Message2: {0}", ex.Message);
                    }
            }
            catch (Exception ex)
            {
                // Display information that command1 failed.
                writer.WriteLine("returnValue for command1:
 {0}", returnValue);
                writer.WriteLine("Exception Message1: {0}", ex.Message);
            }
        }

        // The Complete method commits the transaction. If an exception
 has been thrown,
        // Complete is not  called and the transaction is rolled back.
        scope.Complete();
    }

    // The returnValue is greater than 0 if the transaction committed.
    if (returnValue > 0)
    {
        writer.WriteLine("Transaction was committed.");
    }
    else
    {
        // You could write additional business logic here, for example,
 you can notify the caller 
        // by throwing a TransactionAbortedException, or logging the
 failure.
        writer.WriteLine("Transaction rolled back.");
    }

    // Display messages.
    Console.WriteLine(writer.ToString());

    return returnValue;
}