ISinglePhaseNotification ISinglePhaseNotification ISinglePhaseNotification ISinglePhaseNotification Interface

Définition

Décrit un objet de ressource qui prend en charge l’optimisation de la validation en une phase dans une transaction.Describes a resource object that supports single phase commit optimization to participate in a transaction.

public interface class ISinglePhaseNotification : System::Transactions::IEnlistmentNotification
public interface ISinglePhaseNotification : System.Transactions.IEnlistmentNotification
type ISinglePhaseNotification = interface
    interface IEnlistmentNotification
Public Interface ISinglePhaseNotification
Implements IEnlistmentNotification
Implémente

Remarques

Vous devez noter que même lorsque votre gestionnaire de ressources implémente cette interface pour prendre en charge d’optimisation de validation à phase unique, il n’est pas garanti qu’il reçoit une validation à phase unique.You should note that even when your resource manager implements this interface to support single phase commit optimization, it is not guaranteed that it receives a single phase commit. Le Gestionnaire de transactions peut toujours envoyer des notifications de validation à phase deux à la place.The transaction manager can still send two phase commit notifications instead.

Pour inscrire votre gestionnaire de ressources en tant que participant dans une transaction, appelez le EnlistVolatile méthode ou le EnlistDurable méthode de la Transaction classe.To enlist your resource manager as a participant in a transaction, call the EnlistVolatile method or the EnlistDurable method of the Transaction class. Plus précisément, le EnlistmentOptions paramètre doit être égal à None pour vous assurer qu’une validation à phase unique est effectuée.Specifically, the EnlistmentOptions parameter should equal to None to ensure that a single phase commit is performed. Si elle est définie par inadvertance EnlistDuringPrepareRequired, aucune seule phase de validation se produit.If it is mistakenly set to EnlistDuringPrepareRequired, no single phase commit occurs.

Dans la mesure où le 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.Since the ISinglePhaseNotification interface derives from the IEnlistmentNotification interface, the resource manager must also implement all the methods of the latter for two phase commit notifications. Il s’agit des choix de gestionnaire de transactions quant à la validation si à deux phases ou l’optimisation de la validation en une seule phase est utilisée avec ce gestionnaire de ressources.It is the transaction manager's choice as to whether two phase commit or the single phase commit optimization is used with this resource manager. Toutefois, qui implémente cette interface permet le Gestionnaire de ressources pour tirer parti de l’optimisation lorsqu’il est disponible.However, implementing this interface gives the resource manager the opportunity to take advantage of the optimization when it is available.

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 diverses méthodes de la SinglePhaseEnlistment classe pour informer le Gestionnaire de transactions si le transaction doit être validée ou restaurée.If the optimization is used and the transaction manager calls the SinglePhaseCommit method of the enlisted resource, the resource manager should respond to this call by using various methods of the SinglePhaseEnlistment class to inform the transaction manager if the transaction is to be committed or rolled back.

Méthodes

Commit(Enlistment) Commit(Enlistment) Commit(Enlistment) Commit(Enlistment)

Avertit un objet inscrit qu'une transaction est en cours de validation.Notifies an enlisted object that a transaction is being committed.

(Inherited from IEnlistmentNotification)
InDoubt(Enlistment) InDoubt(Enlistment) InDoubt(Enlistment) InDoubt(Enlistment)

Avertit un objet inscrit que l'état d'une transaction est dans le doute.Notifies an enlisted object that the status of a transaction is in doubt.

(Inherited from IEnlistmentNotification)
Prepare(PreparingEnlistment) Prepare(PreparingEnlistment) Prepare(PreparingEnlistment) Prepare(PreparingEnlistment)

Avertit un objet inscrit qu'une transaction est en cours de préparation pour validation.Notifies an enlisted object that a transaction is being prepared for commitment.

(Inherited from IEnlistmentNotification)
Rollback(Enlistment) Rollback(Enlistment) Rollback(Enlistment) Rollback(Enlistment)

Avertit un objet inscrit qu'une transaction est en cours de restauration (abandonnée).Notifies an enlisted object that a transaction is being rolled back (aborted).

(Inherited from IEnlistmentNotification)
SinglePhaseCommit(SinglePhaseEnlistment) SinglePhaseCommit(SinglePhaseEnlistment) SinglePhaseCommit(SinglePhaseEnlistment) SinglePhaseCommit(SinglePhaseEnlistment)

Représente l’implémentation du Gestionnaire de ressources du rappel pour l’optimisation de la validation en une seule phase.Represents the resource manager's implementation of the callback for the single phase commit optimization.

S’applique à

Voir aussi