ISinglePhaseNotification Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Décrit un objet de ressource qui prend en charge l’optimisation de la validation en une phase dans une transaction.
public interface class ISinglePhaseNotification : System::Transactions::IEnlistmentNotificationpublic interface ISinglePhaseNotification : System.Transactions.IEnlistmentNotificationtype ISinglePhaseNotification = interface
interface IEnlistmentNotificationPublic Interface ISinglePhaseNotification
Implements IEnlistmentNotification- Implémente
Remarques
Notez que même lorsque votre gestionnaire de ressources implémente cette interface pour prendre en charge l’optimisation de validation monophase, il n’est pas garanti qu’il reçoit une validation à phase unique. Le gestionnaire de transactions peut toujours envoyer des notifications de validation en deux phases à la place.
Pour inscrire votre gestionnaire de ressources en tant que participant à une transaction, appelez la EnlistVolatile méthode ou la EnlistDurable méthode de la Transaction classe . Plus précisément, le EnlistmentOptions paramètre doit être égal à pour None garantir qu’une validation en phase unique est effectuée. S’il est défini par erreur sur EnlistDuringPrepareRequired, aucune validation monophase ne se produit.
Étant donné que l’interface ISinglePhaseNotification dérive de l’interface IEnlistmentNotification , le gestionnaire de ressources doit également implémenter toutes les méthodes de cette dernière pour les notifications de validation en deux phases. C’est le choix du gestionnaire de transactions quant à l’utilisation de la validation en deux phases ou de l’optimisation de la validation unique avec ce gestionnaire de ressources. Toutefois, l’implémentation de cette interface donne au gestionnaire de ressources la possibilité de tirer parti de l’optimisation lorsqu’elle est disponible.
Si l’optimisation est utilisée et que le gestionnaire de transactions appelle la SinglePhaseCommit méthode de la ressource inscrite, le gestionnaire de ressources doit répondre à cet appel en utilisant différentes méthodes de la SinglePhaseEnlistment classe pour informer le gestionnaire de transactions si la transaction doit être validée ou restaurée.
Méthodes
| Commit(Enlistment) |
Avertit un objet inscrit qu'une transaction est en cours de validation. (Hérité de IEnlistmentNotification) |
| InDoubt(Enlistment) |
Avertit un objet inscrit que l'état d'une transaction est dans le doute. (Hérité de IEnlistmentNotification) |
| Prepare(PreparingEnlistment) |
Avertit un objet inscrit qu'une transaction est en cours de préparation pour validation. (Hérité de IEnlistmentNotification) |
| Rollback(Enlistment) |
Avertit un objet inscrit qu'une transaction est en cours de restauration (abandonnée). (Hérité de IEnlistmentNotification) |
| SinglePhaseCommit(SinglePhaseEnlistment) |
Représente l'implémentation du gestionnaire de ressources du rappel pour l'optimisation de la validation à phase unique. |
