Enlistment Classe

Definizione

public ref class Enlistment

public class Enlistment

type Enlistment = class

Public Class Enlistment

Ereditarietà

Object

Enlistment

Derivato

System.Transactions.PreparingEnlistment

System.Transactions.SinglePhaseEnlistment

Esempio

Nell'esempio seguente viene illustrata un'implementazione dell' IEnlistmentNotification interfaccia e quando il Done metodo deve essere chiamato.The following example shows an implementation of the IEnlistmentNotification interface, and when the Done method should be called.

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

Commenti

Quando EnlistVolatile EnlistDurable Transaction vengono richiamati i metodi e dell'oggetto per integrare un partecipante a una transazione, viene restituito questo oggetto che descrive l'integrazione.When the EnlistVolatile and EnlistDurable methods of the Transaction object are invoked to enlist a participant in a transaction, they return this object describing the enlistment.

Durante la fase finale del commit della transazione, la gestione transazioni passa questo oggetto a un gestore di risorse che implementa l' IEnlistmentNotification interfaccia integrata in una transazione.During the final phase of the transaction commit, the transaction manager passes this object to a resource manager implementing the IEnlistmentNotification interface that has enlisted in a transaction. In particolare, la gestione transazioni chiama il Commit metodo o Rollback del partecipante, a seconda del fatto che quest'ultimo abbia deciso di eseguire il commit o il rollback della transazione.Specifically, the transaction manager calls either the Commit or the Rollback method of the participant, depending on whether the latter has decided to commit or roll back the transaction. Il partecipante deve chiamare il Done metodo di questo oggetto per comunicare al gestore delle transazioni che ha completato il lavoro.The participant should call the Done method of this object to let the transaction manager know that it has completed its work.

Un elenco può chiamare il Done metodo in qualsiasi momento prima che venga chiamato Prepared nella fase di preparazione.An enlistment can call the Done method at anytime before it has called Prepared in the prepare phase. In questo modo, l'integrazione esegue il cast di un voto di sola lettura, vale a dire che vota il commit sulla transazione, ma non deve ricevere il risultato finale.By doing so, the enlistment is casting a read only vote, meaning that it votes commit on the transaction but does not need to receive the final outcome. Si noti che, dopo la Done chiamata del metodo, il partecipante integrato non riceve altre notifiche dalla gestione transazioni.Note that, after the Done method is called, the enlisted participant receives no further notifications from the transaction manager.

Metodi

Si applica a

Thread safety

Questo tipo è thread-safe.This type is thread safe.

Vedi anche

• PreparingEnlistment
• IEnlistmentNotification
• Integrazione di risorse come partecipanti a una transazioneEnlisting Resources As Participants In A Transaction