ISinglePhaseNotification Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Describe un objeto de recurso que admite la optimización de confirmación de fase única para participar en una transacción.
public interface class ISinglePhaseNotification : System::Transactions::IEnlistmentNotificationpublic interface ISinglePhaseNotification : System.Transactions.IEnlistmentNotificationtype ISinglePhaseNotification = interface
interface IEnlistmentNotificationPublic Interface ISinglePhaseNotification
Implements IEnlistmentNotification- Implementaciones
Comentarios
Debe tener en cuenta que incluso cuando el administrador de recursos implementa esta interfaz para admitir la optimización de confirmación de una sola fase, no se garantiza que reciba una confirmación de una sola fase. En su lugar, el administrador de transacciones puede enviar notificaciones de confirmación en dos fases.
Para dar de alta al administrador de recursos como participante en una transacción, llame al EnlistVolatile método o al EnlistDurable método de la Transaction clase . En concreto, el EnlistmentOptions parámetro debe ser igual a None para asegurarse de que se realiza una confirmación de una sola fase. Si se establece EnlistDuringPrepareRequirederróneamente en , no se produce ninguna confirmación de fase única.
Dado que la ISinglePhaseNotification interfaz se deriva de la IEnlistmentNotification interfaz , el administrador de recursos también debe implementar todos los métodos de este último para las notificaciones de confirmación en dos fases. Es la opción del administrador de transacciones sobre si se usa la confirmación en dos fases o la optimización de confirmación de una sola fase con este administrador de recursos. Sin embargo, la implementación de esta interfaz ofrece al administrador de recursos la oportunidad de aprovechar la optimización cuando está disponible.
Si se usa la optimización y el administrador de transacciones llama al SinglePhaseCommit método del recurso inscrito, el administrador de recursos debe responder a esta llamada mediante varios métodos de la SinglePhaseEnlistment clase para informar al administrador de transacciones si la transacción se va a confirmar o revertir.
Métodos
| Commit(Enlistment) |
Notifica a un objeto inscrito que se confirma una transacción. (Heredado de IEnlistmentNotification) |
| InDoubt(Enlistment) |
Notifica a un objeto inscrito que el estado de una transacción está en duda. (Heredado de IEnlistmentNotification) |
| Prepare(PreparingEnlistment) |
Notifica a un objeto inscrito que se prepara una transacción para la confirmación. (Heredado de IEnlistmentNotification) |
| Rollback(Enlistment) |
Notifica a un objeto inscrito que se deshace (se anula) una transacción. (Heredado de IEnlistmentNotification) |
| SinglePhaseCommit(SinglePhaseEnlistment) |
Representa la implementación del administrador de recursos de la devolución de llamada para la optimización de confirmación en una fase. |
