Freigeben über


Enlistment Klasse

Definition

Erleichtert die Kommunikation zwischen einem eingetragenen Transaktionsteilnehmer und dem Transaktions-Manager während der letzten Phase der Transaktion.

public ref class Enlistment
public class Enlistment
type Enlistment = class
Public Class Enlistment
Vererbung
Enlistment
Abgeleitet

Beispiele

Das folgende Beispiel zeigt eine Implementierung der IEnlistmentNotification Schnittstelle und wann die Done -Methode aufgerufen werden soll.

class myEnlistmentClass : IEnlistmentNotification
{
    public void Prepare(PreparingEnlistment preparingEnlistment)
    {
        Console.WriteLine("Prepare notification received");

        //Perform transactional work

        //If work finished correctly, reply prepared
        preparingEnlistment.Prepared();

        // otherwise, do a ForceRollback
        preparingEnlistment.ForceRollback();
    }

    public void Commit(Enlistment enlistment)
    {
        Console.WriteLine("Commit notification received");

        //Do any work necessary when commit notification is received

        //Declare done on the enlistment
        enlistment.Done();
    }

    public void Rollback(Enlistment enlistment)
    {
        Console.WriteLine("Rollback notification received");

        //Do any work necessary when rollback notification is received

        //Declare done on the enlistment
        enlistment.Done();
    }

    public void InDoubt(Enlistment enlistment)
    {
        Console.WriteLine("In doubt notification received");

        //Do any work necessary when indout notification is received
        
        //Declare done on the enlistment
        enlistment.Done();
    }
}
Public Class EnlistmentClass
    Implements IEnlistmentNotification

    Public Sub Prepare(ByVal myPreparingEnlistment As PreparingEnlistment) Implements System.Transactions.IEnlistmentNotification.Prepare
        Console.WriteLine("Prepare notification received")

        'Perform transactional work

        'If work finished correctly, reply with prepared
        myPreparingEnlistment.Prepared()
    End Sub

    Public Sub Commit(ByVal myEnlistment As Enlistment) Implements System.Transactions.IEnlistmentNotification.Commit
        Console.WriteLine("Commit notification received")

        'Do any work necessary when commit notification is received

        'Declare done on the enlistment
        myEnlistment.Done()
    End Sub

    Public Sub Rollback(ByVal myEnlistment As Enlistment) Implements System.Transactions.IEnlistmentNotification.Rollback
        Console.WriteLine("Rollback notification received")

        'Do any work necessary when rollback notification is received

        'Declare done on the enlistment
        myEnlistment.Done()
    End Sub

    Public Sub InDoubt(ByVal myEnlistment As Enlistment) Implements System.Transactions.IEnlistmentNotification.InDoubt
        Console.WriteLine("In doubt notification received")

        'Do any work necessary when indout notification is received

        'Declare done on the enlistment
        myEnlistment.Done()
    End Sub
End Class

Hinweise

Wenn die EnlistVolatile Methoden und EnlistDurable des Transaction -Objekts aufgerufen werden, um einen Teilnehmer an einer Transaktion einzulisten, geben sie dieses Objekt zurück, das die Aufnahme beschreibt.

In der letzten Phase des Transaktionscommittens übergibt der Transaktions-Manager dieses Objekt an einen Ressourcen-Manager, der die Schnittstelle implementiert, die IEnlistmentNotification in einer Transaktion eingetragen wurde. Insbesondere ruft der Transaktions-Manager entweder die Commit - oder - Rollback Methode des Teilnehmers auf, je nachdem, ob dieser sich für einen Commit oder ein Rollback für die Transaktion entschieden hat. Der Teilnehmer sollte die Done Methode dieses Objekts aufrufen, um den Transaktionsmanager darüber zu informieren, dass er seine Arbeit abgeschlossen hat.

Eine Einlistung kann die Done -Methode jederzeit aufrufen, bevor sie in der Vorbereitungsphase aufgerufen Prepared wurde. Auf diese Weise gibt die Aufnahme eine schreibgeschützte Stimme ab, was bedeutet, dass sie über die Transaktion abstimmt, aber nicht das endgültige Ergebnis erhalten muss. Beachten Sie, dass der beteiligte Teilnehmer nach dem Aufruf der Done Methode keine weiteren Benachrichtigungen vom Transaktions-Manager erhält.

Methoden

Done()

Gibt an, dass der Transaktionsteilnehmer seine Aufgaben abgeschlossen hat.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Threadsicherheit

Dieser Typ ist threadsicher.

Weitere Informationen