Transaction.TransactionCompleted Ereignis

Definition

Namespace:

System.Transactions

Assembly:

System.Transactions.Local.dll

Quelle:

Transaction.cs

Gibt an, dass die Transaktion abgeschlossen ist.

public:
 event System::Transactions::TransactionCompletedEventHandler ^ TransactionCompleted;

public event System.Transactions.TransactionCompletedEventHandler? TransactionCompleted;

member this.TransactionCompleted : System.Transactions.TransactionCompletedEventHandler 

Public Custom Event TransactionCompleted As TransactionCompletedEventHandler 

Ereignistyp

TransactionCompletedEventHandler

Ausnahmen

ObjectDisposedException

Ein Versuch, dieses Ereignis für eine bereits verworfene Transaktion zu abonnieren.

Beispiele

Das folgende Beispiel zeigt, wie eine Anwendung das Ergebnis einer Transaktion abrufen kann, indem sie das TransactionCompleted Ereignis abonniert.

static void Main(string[] args)
{
    try
    {
        //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();
                Console.WriteLine();

                if ((c.KeyChar == 'Y') || (c.KeyChar == 'y'))
                {
                    scope.Complete();
                    break;
                }
                else if ((c.KeyChar == 'N') || (c.KeyChar == 'n'))
                {
                    break;
                }
            }
        }
    }
    catch (System.Transactions.TransactionException ex)
    {
        Console.WriteLine(ex);
    }
    catch
    {
        Console.WriteLine("Cannot complete transaction");
        throw;
    }
}

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

Public Shared Sub Main()
    Try
        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()
                Console.WriteLine()
                If (c.KeyChar = "Y") Or (c.KeyChar = "y") Then
                    scope.Complete()
                    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(ex)
    Catch
        Console.WriteLine("Cannot complete transaction")
        Throw
    End Try
End Sub

'Transaction completed event handler
Private 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

Hinweise

Sie können sich für dieses Ereignis registrieren, anstatt eine flüchtige Eintragung zu verwenden, um Ergebnisinformationen für Transaktionen abzurufen. Der an den TransactionCompletedEventHandler Delegaten übergebene Parameter ist ein Transaction instance. Anschließend können Sie die TransactionInformation -Eigenschaft des spezifischen instance abfragen, um eine instance von TransactionInformationabzurufen, deren Status Eigenschaft die status einer Transaktion mit dem - oder Aborted -CommittedWert enthält.

Vorsicht Die Registrierung für dieses Ereignis wirkt sich negativ auf die Leistung der Transaktion aus, an die es angefügt ist.