Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ISinglePhaseNotification interface

 

Date de publication : juillet 2016

Décrit un objet de ressource qui prend en charge l’optimisation de la validation en une phase dans une transaction.

Espace de noms:   System.Transactions
Assembly:  System.Transactions (dans System.Transactions.dll)

public interface ISinglePhaseNotification : IEnlistmentNotification

NomDescription
System_CAPS_pubmethodCommit(Enlistment)

Avertit un inscrit qu’une transaction est en cours de validation de l’objet.(Hérité de IEnlistmentNotification.)

System_CAPS_pubmethodInDoubt(Enlistment)

Avertit un objet inscrit que l’état d’une transaction est incertaine.(Hérité de IEnlistmentNotification.)

System_CAPS_pubmethodPrepare(PreparingEnlistment)

Avertit un objet inscrit qu’une transaction est en cours de préparation pour validation.(Hérité de IEnlistmentNotification.)

System_CAPS_pubmethodRollback(Enlistment)

Avertit un objet inscrit qu’une transaction est restaurée (abandonnée).(Hérité de IEnlistmentNotification.)

System_CAPS_pubmethodSinglePhaseCommit(SinglePhaseEnlistment)

Représente l’implémentation du Gestionnaire de ressources du rappel pour l’optimisation de la validation en une seule phase.

Notez que même lorsque votre gestionnaire de ressources implémente cette interface pour prendre en charge d’optimisation de la validation à phase unique, il n’est pas garanti qu’il reçoit une validation à phase unique. Le Gestionnaire de transactions peut toujours envoyer les notifications de la validation à deux phases à la place.

Pour inscrire votre gestionnaire de ressources en tant que participant dans une transaction, appelez le EnlistVolatile méthode ou la EnlistDurable méthode de la Transaction classe. Plus précisément, le EnlistmentOptions doit être égal au paramètre None pour vous assurer qu’une seule phase validation est exécutée. Si elle est définie par erreur EnlistDuringPrepareRequired, aucune unique phase de validation se produit.

Étant donné que la ISinglePhaseNotification interface dérive le IEnlistmentNotification interface, le Gestionnaire de ressources doit également implémenter toutes les méthodes de ce dernier pour les notifications de validation à deux phases. Il s’agit de choix du Gestionnaire de transactions que si deux phases de la validation ou l’optimisation de la validation à phase unique est utilisée avec ce gestionnaire de ressources. Toutefois, qui implémente cette interface permet au Gestionnaire de ressources pour 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.

.NET Framework
Disponible depuis 2.0
Retour au début
Afficher: