ISinglePhaseNotification 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 de recurso que dá suporte à otimização de confirmação de fase única para participar de uma transação.
public interface class ISinglePhaseNotification : System::Transactions::IEnlistmentNotificationpublic interface ISinglePhaseNotification : System.Transactions.IEnlistmentNotificationtype ISinglePhaseNotification = interface
interface IEnlistmentNotificationPublic Interface ISinglePhaseNotification
Implements IEnlistmentNotification- Implementações
Comentários
Você deve observar que, mesmo quando o gerenciador de recursos implementa essa interface para dar suporte à otimização de confirmação de fase única, não é garantido que ele receba uma confirmação de fase única. Em vez disso, o gerenciador de transações ainda pode enviar notificações de confirmação em duas fases.
Para inscrever o gerenciador de recursos como participante em uma transação, chame o EnlistVolatile método ou o EnlistDurable método da Transaction classe. Especificamente, o EnlistmentOptions parâmetro deve ser igual a None garantir que uma confirmação de fase única seja executada. Se ele estiver definido EnlistDuringPrepareRequiredcomo erroneamente, nenhuma confirmação de fase única ocorrerá.
Como a ISinglePhaseNotification interface deriva da IEnlistmentNotification interface, o gerenciador de recursos também deve implementar todos os métodos deste último para duas notificações de confirmação de fase. É a escolha do gerenciador de transações se a confirmação de duas fases ou a otimização de confirmação de fase única é usada com esse gerenciador de recursos. No entanto, a implementação dessa interface dá ao gerenciador de recursos a oportunidade de aproveitar a otimização quando ela estiver disponível.
Se a otimização for usada e o gerenciador de transações chamar o SinglePhaseCommit método do recurso inscrito, o gerenciador de recursos deverá responder a essa chamada usando vários métodos da SinglePhaseEnlistment classe para informar ao gerenciador de transações se a transação deve ser confirmada ou revertida.
Métodos
| Nome | Description |
|---|---|
| Commit(Enlistment) |
Notifica um objeto inscrito de que uma transação está sendo confirmada. (Herdado de IEnlistmentNotification) |
| InDoubt(Enlistment) |
Notifica um objeto inscrito de que o status de uma transação está em dúvida. (Herdado de IEnlistmentNotification) |
| Prepare(PreparingEnlistment) |
Notifica um objeto inscrito de que uma transação está sendo preparada para compromisso. (Herdado de IEnlistmentNotification) |
| Rollback(Enlistment) |
Notifica um objeto inscrito de que uma transação está sendo revertida (anulada). (Herdado de IEnlistmentNotification) |
| SinglePhaseCommit(SinglePhaseEnlistment) |
Representa a implementação do retorno de chamada do gerenciador de recursos para a otimização de confirmação de fase única. |
