IPromotableSinglePhaseNotification Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Descreve um objeto que atua como um delegado de confirmação de uma transação não distribuída interna de um 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 inscrições passíveis de promoção (PSPE) permitem que um recurso, como um banco de dados, assuma a propriedade da transação se for a única entidade que participa da transação. Posteriormente, se necessário, a System.Transactions infraestrutura ainda poderá escalonar a transação para MSDTC. Para obter mais informações, consulte Otimização usando confirmação de fase única e Notificação de fase única passível de promoção.
Um gerenciador de recursos que implementa essa interface delega o controle da confirmação de sua transação interna não distribuída a uma inscrição em uma System.Transactions transação por meio do EnlistPromotableSinglePhase método na Transaction classe .
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.
Depois de inscrever um objeto que implementa essa interface como participante de uma transação usando o EnlistPromotableSinglePhase método , o gerenciador de transações notifica o participante quando a transação é promovida, confirmada ou revertida invocando o Promote método, o SinglePhaseCommit método ou o Rollback método do objeto.
Para obter mais informações, consulte Otimização usando confirmação de fase única e Notificação de fase única passível de promoção.
Métodos
Initialize() |
Notifica um participante da transação de que a inscrição foi concluída com êxito. |
Promote() |
Notifica um objeto inscrito solicitado por um escalonamento da transação delegada. (Herdado de ITransactionPromoter) |
Rollback(SinglePhaseEnlistment) |
Notifica um objeto inscrito de que a transação está sendo revertida. |
SinglePhaseCommit(SinglePhaseEnlistment) |
Notifica um objeto inscrito de que a transação está sendo confirmada. |