Enlistment Classe

Definição

Facilita a comunicação entre um participante de transação inscrito e o gerenciador de transação durante a fase final da transação.Facilitates communication between an enlisted transaction participant and the transaction manager during the final phase of the transaction.

public ref class Enlistment
public class Enlistment
type Enlistment = class
Public Class Enlistment
Herança
Enlistment
Derivado

Exemplos

O exemplo a seguir mostra uma implementação do IEnlistmentNotification interface e quando o Done método deve ser chamado.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

Comentários

Quando o EnlistVolatile e EnlistDurable métodos do Transaction objeto são invocados para inscrever um participante em uma transação, elas retornarão esse objeto que descreve a inscrição.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 a fase final da confirmação de transação, o Gerenciador de transação passa esse objeto para um Gerenciador de recursos Implementando o IEnlistmentNotification interface que foi inscrito em uma transação.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. Especificamente, o Gerenciador de transações chama o Commit ou o Rollback método do participante, dependendo se o último decidiu confirmar ou reverter a transação.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. O participante deve chamar o Done método desse objeto para informar o Gerenciador de transações que concluiu seu trabalho.The participant should call the Done method of this object to let the transaction manager know that it has completed its work.

Uma inscrição pode chamar o Done método na qualquer momento antes que ele é chamado Prepared na fase de preparação.An enlistment can call the Done method at anytime before it has called Prepared in the prepare phase. Ao fazer isso, a inscrição está convertendo um voto de somente leitura, que significa que ele votos confirmação na transação, mas não precisa receber o resultado final.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. Observe que, após o Done método é chamado, o participante inscrito recebe nenhuma notificação adicional do Gerenciador de transações.Note that, after the Done method is called, the enlisted participant receives no further notifications from the transaction manager.

Métodos

Done()

Indica que o participante da transação concluiu seu trabalho.Indicates that the transaction participant has completed its work.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a

Acesso thread-safe

Este tipo é thread-safe.This type is thread safe.

Veja também