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 validation par phase unique pour participer à 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 à phase unique, il n’est pas garanti qu’elle reçoit une validation de 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 à None s’assurer qu’une validation de phase unique est effectuée. S’il est défini EnlistDuringPrepareRequiredpar erreur sur , aucune validation de phase unique 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. Il s’agit du choix du gestionnaire de transactions quant à savoir si la validation en deux phases ou l’optimisation de validation à phase unique est utilisée 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 à l’aide de 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
| Nom | Description |
|---|---|
| Commit(Enlistment) |
Avertit un objet inscrit qu’une transaction est validée. (Hérité de IEnlistmentNotification) |
| InDoubt(Enlistment) |
Avertit un objet inscrit que l’état d’une transaction est en doute. (Hérité de IEnlistmentNotification) |
| Prepare(PreparingEnlistment) |
Avertit un objet inscrit qu’une transaction est préparée pour l’engagement. (Hérité de IEnlistmentNotification) |
| Rollback(Enlistment) |
Avertit un objet inscrit qu’une transaction est restaurée (abandonnée). (Hérité de IEnlistmentNotification) |
| SinglePhaseCommit(SinglePhaseEnlistment) |
Représente l’implémentation du gestionnaire de ressources du rappel pour l’optimisation de validation en phase unique. |
