Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Transaction.TransactionCompleted Event

Indicates that the transaction is completed.

Namespace: System.Transactions
Assembly: System.Transactions (in system.transactions.dll)

public event TransactionCompletedEventHandler TransactionCompleted
/** @event */
public void add_TransactionCompleted (TransactionCompletedEventHandler value)

/** @event */
public void remove_TransactionCompleted (TransactionCompletedEventHandler value)

In JScript, you can handle the events defined by a class, but you cannot define your own.
Not applicable.

Exception typeCondition


An attempt to subscribe this event on a transaction that has been disposed.

You can register for this event instead of using a volatile enlistment to get outcome information for transactions. The parameter passed to the TransactionCompletedEventHandler delegate is a Transaction instance. You can then query the TransactionInformation property of the specific instance to get an instance of TransactionInformation, whose Status property contains the status of a transaction with either the Committed or Aborted value.

Caution   Signing up for this event negatively affects the performance of the transaction it is attached to.

The following sample shows how an application can obtain the outcome of a transaction by subscribing to the TransactionCompleted event.

static void Main(string[] args)
        //Create the transaction scope
        using (TransactionScope scope = new TransactionScope())
            //Register for the transaction completed event for the current transaction
            Transaction.Current.TransactionCompleted += new TransactionCompletedEventHandler(Current_TransactionCompleted);

            //Call complete on the TransactionScope based on console input
            ConsoleKeyInfo c;
            while (true)
                Console.Write("Complete the transaction scope? [Y|N] ");
                c = Console.ReadKey();

                if ((c.KeyChar == 'Y') || (c.KeyChar == 'y'))
                else if ((c.KeyChar == 'N') || (c.KeyChar == 'n'))


    catch (System.Transactions.TransactionException ex)
        Console.WriteLine("Cannot complete transaction");

//Transaction completed event handler
static void Current_TransactionCompleted(object sender, TransactionEventArgs e)
    Console.WriteLine("A transaction has completed:");
    Console.WriteLine("ID:             {0}", e.Transaction.TransactionInformation.LocalIdentifier);
    Console.WriteLine("Distributed ID: {0}", e.Transaction.TransactionInformation.DistributedIdentifier);
    Console.WriteLine("Status:         {0}", e.Transaction.TransactionInformation.Status);
    Console.WriteLine("IsolationLevel: {0}", e.Transaction.IsolationLevel);

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0

Community Additions

© 2015 Microsoft