TransactionScope.Dispose メソッド

public:
 virtual void Dispose();

public void Dispose ();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Sub 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.
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();

    try
    {
        // 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))
            {
                // 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))
                {
                    // 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);
                }
            }

            // The Complete method commits the transaction. If an exception has been thrown,
            // Complete is not  called and the transaction is rolled back.
            scope.Complete();
        }
    }
    catch (TransactionAbortedException ex)
    {
        writer.WriteLine("TransactionAbortedException Message: {0}", ex.Message);
    }

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

    return returnValue;
}

'  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)
    End Try

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

    Return returnValue
End Function

注釈

このメソッドを呼び出すと、トランザクション スコープの末尾がマークされます。 オブジェクトがトランザクションを TransactionScope 作成し、 Complete スコープで呼び出された場合、 TransactionScope オブジェクトはこのメソッドの呼び出し時にトランザクションのコミットを試みます。 この場合、このメソッドはトランザクション処理の最初のフェーズが完了するまでブロックします。 最初のフェーズは、トランザクション内のすべてのリソース マネージャーと参加リストがトランザクションの結果に投票し TransactionManager 、 がトランザクションのコミットまたは中止を永続的に決定した後に終了します。 処理の 2 番目のフェーズは常に非同期です。 したがって、別のトランザクションを使用してこのデータを表示しない場合、特定のトランザクション内からコミットされたデータが後ですぐに使用できるようになるという保証はありません。

C# using 構築を使用すると、例外が発生した場合でも、このメソッドが確実に呼び出されます。 このメソッドの呼び出し後に発生した例外は、トランザクションに影響しない場合があります。 この方法では、アンビエント トランザクションも元の状態に復元されます。 TransactionAbortedExceptionトランザクションが実際にコミットされていない場合は、 がスローされます。

このメソッドは、トランザクション処理の最初のフェーズが完了するまでブロックするため、Windows フォーム (WinForm) アプリケーションでこのメソッドを使用する場合、またはデッドロックが発生する可能性がある場合は、非常に注意する必要があります。 1 つの WinForm Control イベント (ボタンのクリックなど) 内でこのメソッドを呼び出し、同期 Invoke メソッドを使用して、トランザクションの処理中にいくつかの UI タスク (色の変更など) を実行するようにコントロールに指示すると、デッドロックが発生します。 これは、 Invoke メソッドが同期的であり、UI スレッドがそのジョブを終了するまでワーカー スレッドをブロックするためです。 ただし、このシナリオでは、UI スレッドもワーカー スレッドがトランザクションをコミットするのを待機しています。 その結果、何も続行できず、スコープはコミットが完了するまで無期限に待機します。 非同期であり、デッドロックが発生しにくくなるため、可能な限りではなく Invoke を使用BeginInvokeする必要があります。

このメソッドの使用方法の詳細については、「 トランザクション スコープを使用した暗黙的なトランザクションの実装 」トピックを参照してください。

適用対象

こちらもご覧ください

• トランザクション スコープを使用した暗黙的なトランザクションの実装