更新 : 2007 年 11 月
コード ブロックをトランザクションにします。このクラスは継承できません。
名前空間 :
System.Transactions アセンブリ :
System.Transactions (System.Transactions.dll 内)
Public NotInheritable Class TransactionScope _
Implements IDisposable
Dim instance As TransactionScope
public sealed class TransactionScope : IDisposable
public ref class TransactionScope sealed : IDisposable
public final class TransactionScope implements IDisposable
public final class TransactionScope implements IDisposable
System.Transactions インフラストラクチャは、Transaction クラスに基づく明示的なプログラミング モデルだけでなく、インフラストラクチャがトランザクションを自動的に管理する、TransactionScope クラスを使用した暗黙のプログラミング モデルも提供します。
new ステートメントで TransactionScope をインスタンス化すると、トランザクション マネージャによって参加するトランザクションが決定されます。いったん決定されると、このスコープは常にそのトランザクションに参加します。この決定は 2 つの要因に基づいて行われます。1 つはアンビエント トランザクションが存在するかどうか、もう 1 つはコンストラクタの TransactionScopeOption パラメータの値です。アンビエント トランザクションとは、その中でコードが実行されるトランザクションです。Transaction クラスの静的 Current プロパティを呼び出すことによってアンビエント トランザクションへの参照を取得できます。このパラメータの使用方法の詳細については、「トランザクション スコープを使用した暗黙的なトランザクションの実装」で、トランザクション フローの管理についての説明を参照してください。
トランザクション スコープ内 (つまり、TransactionScope オブジェクトの初期化からその Dispose メソッドの呼び出しまでの間) で例外が発生しなかった場合、スコープが参加しているトランザクションを続行できます。トランザクション スコープ内で例外が発生した場合、スコープが参加しているトランザクションはロールバックされます。
アプリケーションがトランザクション内で実行する必要のあるすべての作業を完了したら、トランザクション マネージャにトランザクションをコミットできることを知らせるために、Complete メソッドを一度だけ呼び出す必要があります。このメソッドを呼び出さないと、トランザクションが中止されます。
Dispose メソッドの呼び出しによって、トランザクション スコープの末尾がマークされます。このメソッドの呼び出し後に発生した例外は、トランザクションに影響しない場合があります。
スコープ内で Current の値を変更すると、Dispose を呼び出したときに例外がスローされます。ただし、スコープの末尾では以前の値が復元されます。また、トランザクションを作成したトランザクション スコープ内のCurrent で Dispose を呼び出した場合、このトランザクションはスコープの末尾で中止されます。
次の例では、TransactionScope クラスを使用してトランザクションに参加するコード ブロックを定義する方法を示します。
' 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 3rd party RDBMS
' 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
Try
' 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)
' 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)
' 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)
End Using
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
Catch ex As TransactionAbortedException
writer.WriteLine("TransactionAbortedException Message: {0}", ex.Message)
Catch ex As ApplicationException
writer.WriteLine("ApplicationException Message: {0}", ex.Message)
End Try
' 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 3rd party RDBMS
' 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
Try
' 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)
' 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)
' 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)
End Using
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
Catch ex As TransactionAbortedException
writer.WriteLine("TransactionAbortedException Message: {0}", ex.Message)
Catch ex As ApplicationException
writer.WriteLine("ApplicationException Message: {0}", ex.Message)
End Try
' Display messages.
Console.WriteLine(writer.ToString())
Return returnValue
End Function
System..::.Object
System.Transactions..::.TransactionScope
この型は、スレッド セーフです。
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
.NET Framework
サポート対象 : 3.5、3.0、2.0
参照
その他の技術情報