TransactionScope.Dispose メソッドとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

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

TransactionScope.Dispose メソッド

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

トランザクションスコープを終了します。

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

Visual Basic (宣言)

Public Sub Dispose

Visual Basic (使用法)

Dim instance As TransactionScope

instance.Dispose

public void Dispose ()

C++

public:
virtual void Dispose () sealed

public final void Dispose ()

JScript

public final function Dispose ()

解説

このメソッドを呼び出すとトランザクションスコープの末尾がマークされます。TransactionScope オブジェクトによってトランザクションが作成され、スコープで Complete が呼び出された場合、このメソッドを呼び出すと、TransactionScope オブジェクトはトランザクションをコミットしようとします。

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

このメソッドは同期的に動作し、トランザクションがコミットまたは中止されるまでブロックします。そのため、このメソッドを Windows フォーム (WinForm) アプリケーションで使用する場合は、デッドロックの発生に十分な注意が必要です。WinForm コントロールイベント (ボタンクリックなど) でこのメソッドを呼び出し、トランザクションの処理中に同期メソッド Invoke を使用して、制御をなんらかの UI タスク (色の変更など) にリダイレクトした場合、デッドロックが発生します。これは、Invoke メソッドが同期的に動作し、UI スレッドが処理を終えるまでワーカースレッドがブロックされるためです。また、この場合、UI スレッド側も、ワーカースレッドがトランザクションのコミットを完了するまで待機しようとします。その結果、いずれも処理を行うことができず、決して終わることのないコミット処理を無期限に待機することとなってしまいます。このため、できるだけ Invoke は使わずに、非同期で動作する BeginInvoke を使用することをお勧めします。こうすることで、デッドロックの発生を抑えることができます。

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

使用例

次の例では、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;
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TransactionScope クラス
TransactionScope メンバ
System.Transactions 名前空間
その他の技術情報
トランザクションスコープを使用した暗黙的なトランザクションの実装

このページでは「.NET Framework クラスライブラリリファレンス」からTransactionScope.Dispose メソッドを検索した結果を表示しています。
Weblioに収録されているすべての辞書からTransactionScope.Dispose メソッドを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からTransactionScope.Dispose メソッドを検索

>> 「TransactionScope.Dispose メソッド」を含む用語の索引
TransactionScope.Dispose メソッドのページへのリンク


	© 2025 Microsoft.All rights reserved.

TransactionScope.Dispose メソッドとは？ わかりやすく解説

TransactionScope.Dispose メソッド

急上昇のことば

TransactionScope.Dispose メソッドとは？わかりやすく解説