Condividi tramite


Enlistment Classe

Definizione

Facilita la comunicazione tra un partecipante alla transazione integrato e la gestione transazioni durante la fase finale della transazione.

public ref class Enlistment
public class Enlistment
type Enlistment = class
Public Class Enlistment
Ereditarietà
Enlistment
Derivato

Esempio

Nell'esempio seguente viene illustrata un'implementazione dell'interfaccia IEnlistmentNotification e quando il Done metodo deve essere chiamato.

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 i EnlistVolatile metodi e EnlistDurable dell'oggetto vengono richiamati per inserire un partecipante in una transazione, restituiscono questo oggetto che descrive l'elenco Transaction .

Durante la fase finale del commit della transazione, gestione transazioni passa questo oggetto a un resource manager che implementa l'interfaccia IEnlistmentNotification che è elencata in una transazione. In particolare, il gestore delle transazioni chiama il Commit metodo o il Rollback metodo del partecipante, a seconda che quest'ultimo abbia deciso di eseguire il commit o il rollback della transazione. Il partecipante deve chiamare il Done metodo di questo oggetto per consentire al gestore transazioni di sapere che ha completato il suo lavoro.

Un elenco può chiamare il Done metodo in qualsiasi momento prima che venga chiamato Prepared nella fase di preparazione. A tale scopo, l'inserimento viene eseguito il cast di un voto di sola lettura, vale a dire che vota il commit per la transazione, ma non deve ricevere il risultato finale. Si noti che, dopo aver chiamato il metodo, il Done partecipante incluso non riceve ulteriori notifiche dal gestore transazioni.

Metodi

Done()

Indica che il partecipante alla transazione ha completato le relative operazioni.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Thread safety

Questo tipo è thread-safe.

Vedi anche