This documentation is archived and is not being maintained.

TransactionCompletedEventHandler Delegate

Note: This delegate is new in the .NET Framework version 2.0.

Represents the method that handles the TransactionCompleted event of a Transaction class.

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

Public Delegate Sub TransactionCompletedEventHandler ( _
	sender As Object, _
	e As TransactionEventArgs _
Dim instance As New TransactionCompletedEventHandler(AddressOf HandlerMethod)
/** @delegate */
public delegate void TransactionCompletedEventHandler (
	Object sender, 
	TransactionEventArgs e
JScript supports the use of delegates, but not the declaration of new ones.



The source of the event.


The TransactionEventArgs that contains the event data.

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

Public Shared Sub Main()
        Using scope As TransactionScope = New TransactionScope()

            'Register for the transaction completed event for the current transaction
            AddHandler Transaction.Current.TransactionCompleted, AddressOf Current_TransactionCompleted

            'Perform transactional work here.

            'Call complete on the TransactionScope based on console input
            Dim c As ConsoleKeyInfo
            While (True)

                Console.Write("Complete the transaction scope? [Y|N] ")
                c = Console.ReadKey()
                If (c.KeyChar = "Y") Or (c.KeyChar = "y") Then
                    Exit While
                ElseIf ((c.KeyChar = "N") Or (c.KeyChar = "n")) Then
                    Exit While
                End If
            End While

        End Using
    Catch ex As TransactionException
        Console.WriteLine("Cannot complete transaction")
    End Try
End Sub

'Transaction completed event handler
Public Shared Sub Current_TransactionCompleted(ByVal sender As Object, ByVal e As TransactionEventArgs)
    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)
End Sub

Windows 98, Windows 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 .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0