Enlistment Klasse

Definition

public ref class Enlistment

public class Enlistment

type Enlistment = class

Public Class Enlistment

Vererbung

Object

Enlistment

Abgeleitet

System.Transactions.PreparingEnlistment

System.Transactions.SinglePhaseEnlistment

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 Methoden des Transaction Objekts aufgerufen werden, um einen Teilnehmer einer Transaktion aufzurufen, geben sie dieses Objekt zurück, das die Auflistung beschreibt.

Während der letzten Phase des Transaktions-Commits übergibt der Transaktionsmanager dieses Objekt an einen Ressourcen-Manager, der die Schnittstelle implementiert, die IEnlistmentNotification in einer Transaktion aufgelistet wurde. Insbesondere ruft der Transaktionsmanager entweder die Commit Methode oder die Rollback Methode des Teilnehmers auf, je nachdem, ob letztere beschlossen hat, die Transaktion zu übernehmen oder zurückzunehmen. Der Teilnehmer sollte die Done Methode dieses Objekts aufrufen, um dem Transaktionsmanager mitzuteilen, dass er seine Arbeit abgeschlossen hat.

Eine Liste kann die Done Methode jederzeit aufrufen, bevor sie in der Vorbereitungsphase aufgerufen Prepared wurde. Auf diese Weise wird die Auflistung eine schreibgeschützte Abstimmung abgegeben, d. h., sie stimmt über die Transaktion ab, muss aber nicht das endgültige Ergebnis erhalten. Beachten Sie, dass der aufgelistete Teilnehmer nach dem Aufrufen der Done Methode keine weiteren Benachrichtigungen vom Transaktions-Manager erhält.

Threadsicherheit

Dieser Typ ist threadsicher.

Weitere Informationen

• PreparingEnlistment
• IEnlistmentNotification
• Enlisting von Ressourcen als Teilnehmer einer Transaktion