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

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

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

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

TransactionScope.Complete メソッド

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

スコープ内のすべての操作が正常に完了したことを示します。

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

Visual Basic (宣言)

Public Sub Complete

Visual Basic (使用法)

Dim instance As TransactionScope

instance.Complete

public void Complete ()

C++

public:
void Complete ()

public void Complete ()

JScript

public function Complete ()

例外

例外の種類	条件
InvalidOperationException	このメソッドは、既に一度呼び出されています。

解説

スコープ内のすべての操作が正常に完了していることが確認できたら、このメソッドを一度だけ呼び出して、すべてのリソースの状態に一貫性があること、およびトランザクションをコミットできる状態にあることをトランザクションマネージャに通知する必要があります。using ブロックの最後のステートメントとしてこの呼び出しを配置することを強くお勧めします。

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

この呼び出しを行わないと、トランザクションマネージャは、システム障害が発生したかまたはトランザクションのスコープ内で例外がスローされたと解釈するため、トランザクションが中止されます。ただし、このメソッドを呼び出したからといって必ずしもトランザクションのコミットが保証されるわけではありません。これはトランザクションマネージャにステータスを通知する手段にすぎません。このメソッドを呼び出した後は、Current プロパティを介してアンビエントトランザクションにアクセスできなくなります。アクセスしようとすると例外がスローされます。

TransactionScope オブジェクトによってトランザクションを作成した場合、リソースマネージャ間での実際のコミット作業は End Using ステートメントで実行されます。このオブジェクトによってトランザクションが作成されていない場合、CommittableTransaction オブジェクトの所有者によって Commit が呼び出されるたびにコミットが発生します。その時点で、このメソッドが TransactionScope オブジェクトで呼び出されたかどうかに基づいて、トランザクションマネージャがリソースマネージャを呼び出し、コミットするかロールバックするかを通知します。

使用例

次の例では、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.Complete メソッドを検索した結果を表示しています。
Weblioに収録されているすべての辞書からTransactionScope.Complete メソッドを検索する場合は、下記のリンクをクリックしてください。

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

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


	© 2025 Microsoft.All rights reserved.

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

TransactionScope.Complete メソッド

急上昇のことば

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