IPromotableSinglePhaseNotification Interface

Definição

Descreve um objeto que atua como um delegado de confirmação de uma transação não distribuída interna de um Resource Manager.Describes an object that acts as a commit delegate for a non-distributed transaction internal to a resource manager.

public interface class IPromotableSinglePhaseNotification : System::Transactions::ITransactionPromoter
public interface IPromotableSinglePhaseNotification : System.Transactions.ITransactionPromoter
type IPromotableSinglePhaseNotification = interface
    interface ITransactionPromoter
Public Interface IPromotableSinglePhaseNotification
Implements ITransactionPromoter
Implementações

Comentários

As inlistagens promocionais (PSPE) permitem que um recurso, como um banco de dados, assuma a propriedade da transação se ela for a única entidade que participa da transação.Promotable Enlistments (PSPE) allow a resource, such as a database, to take ownership of the transaction if it is the only entity participating in the transaction. Posteriormente, se necessário, a System.Transactions infraestrutura ainda poderá escalonar a transação para o MSDTC.Later, if needed, the System.Transactions infrastructure can still escalate the transaction to MSDTC. Para obter mais informações, consulte otimização usando confirmação de fase única e notificação de fase única de promoçãotable.For more information, see Optimization Using Single Phase Commit and Promotable Single Phase Notification.

Um Gerenciador de recursos que implementa essa interface delega o controle da confirmação da transação não distribuída interna a uma inscrição em uma System.Transactions transação por meio do EnlistPromotableSinglePhase método na Transaction classe.A resource manager that implements this interface delegates control of the commit of it's internal non-distributed transaction to an enlistment on a System.Transactions transaction through the EnlistPromotableSinglePhase method on the Transaction class.

Se o ITransactionPromoter.Promote método for chamado, sua implementação dessa interface deverá produzir uma transação distribuída na forma de um token de propagação e retorná-la para System.Transactions .If the ITransactionPromoter.Promote method is called, your implementation of this interface must produce a distributed transaction in the form of a propagation token, and return it to System.Transactions.

Depois que você inscrever um objeto que implementa essa interface como um participante de uma transação usando o EnlistPromotableSinglePhase método, o Gerenciador de transações notificará o participante quando a transação for promovida, confirmada ou revertida invocando o Promote método, o SinglePhaseCommit método ou o Rollback método do objeto.After you enlist an object that implements this interface as a participant of a transaction using the EnlistPromotableSinglePhase method, the transaction manager then notifies the participant when the transaction is promoted, committed, or rolled back by invoking the Promote method, the SinglePhaseCommit method, or the Rollback method of the object.

Para obter mais informações, consulte otimização usando confirmação de fase única e notificação de fase única de promoçãotable.For more information, see Optimization Using Single Phase Commit and Promotable Single Phase Notification.

Métodos

Initialize()

Notifica um participante da transação de que a inscrição foi concluída com êxito.Notifies a transaction participant that enlistment has completed successfully.

Promote()

Notifica um objeto inscrito solicitado por um escalonamento da transação delegada.Notifies an enlisted object that an escalation of the delegated transaction has been requested.

(Herdado de ITransactionPromoter)
Rollback(SinglePhaseEnlistment)

Notifica um objeto inscrito de que a transação está sendo revertida.Notifies an enlisted object that the transaction is being rolled back.

SinglePhaseCommit(SinglePhaseEnlistment)

Notifica um objeto inscrito de que a transação está sendo confirmada.Notifies an enlisted object that the transaction is being committed.

Aplica-se a

Confira também