Enlistment Klas

Definitie

public ref class Enlistment

public class Enlistment

type Enlistment = class

Public Class Enlistment

Overname

Object

Enlistment

Afgeleid

System.Transactions.PreparingEnlistment

System.Transactions.SinglePhaseEnlistment

Voorbeelden

In het volgende voorbeeld ziet u een implementatie van de IEnlistmentNotification interface en wanneer de Done methode moet worden aangeroepen.

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

Opmerkingen

Wanneer de EnlistVolatile en EnlistDurable methoden van het Transaction object worden aangeroepen om een deelnemer in een transactie in te schakelen, retourneren ze dit object met een beschrijving van de aanhaling.

Tijdens de laatste fase van de transactiedoorvoering geeft de transactiebeheerder dit object door aan een resourcemanager die de IEnlistmentNotification interface implementeert die is opgenomen in een transactie. Met name de transactiebeheerder roept de Commit of de Rollback methode van de deelnemer aan, afhankelijk van of de laatste heeft besloten de transactie vast te leggen of terug te draaien. De deelnemer moet de Done methode van dit object aanroepen om de transactiebeheerder te laten weten dat het werk is voltooid.

Een opname kan de Done methode op elk gewenst moment aanroepen voordat deze in de voorbereidingsfase is aangeroepen Prepared . Door dit te doen, is de opname een alleen-lezen stem, wat betekent dat het stemmen doorvoert op de transactie, maar niet het uiteindelijke resultaat hoeft te ontvangen. Nadat de Done methode is aangeroepen, ontvangt de ingeschreven deelnemer geen verdere meldingen van de transactiebeheerder.

Veiligheid thread

Dit type is thread veilig.

Zie ook

• PreparingEnlistment
• IEnlistmentNotification
• Resources inschakelen als deelnemers aan een transactie