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 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

Gilt für:

Threadsicherheit

Dieser Typ ist threadsicher.

Weitere Informationen

• PreparingEnlistment
• IEnlistmentNotification
• Eintragen von Ressourcen als Teilnehmer an einer Transaktion