Transaction.EnlistDurable Méthode
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.
Inscrit un gestionnaire de ressources durable à participer à une transaction.
Surcharges
| EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions) |
Inscrit un gestionnaire de ressources durable qui prend en charge la validation à deux phases pour participer à une transaction. |
| EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions) |
Inscrit un gestionnaire de ressources durable qui prend en charge l'optimisation de la validation à phase unique pour participer à une transaction. |
Remarques
Notes
Cette méthode l’utilise LinkDemand pour empêcher son appel à partir de code non approuvé ; toutefois, seul l’appelant immédiat est requis pour posséder le jeu d’autorisations FullTrust .
EnlistDurable(Guid, IEnlistmentNotification, EnlistmentOptions)
- Source:
- Transaction.cs
- Source:
- Transaction.cs
- Source:
- Transaction.cs
Inscrit un gestionnaire de ressources durable qui prend en charge la validation à deux phases pour participer à une transaction.
public:
System::Transactions::Enlistment ^ EnlistDurable(Guid resourceManagerIdentifier, System::Transactions::IEnlistmentNotification ^ enlistmentNotification, System::Transactions::EnlistmentOptions enlistmentOptions);public System.Transactions.Enlistment EnlistDurable (Guid resourceManagerIdentifier, System.Transactions.IEnlistmentNotification enlistmentNotification, System.Transactions.EnlistmentOptions enlistmentOptions);member this.EnlistDurable : Guid * System.Transactions.IEnlistmentNotification * System.Transactions.EnlistmentOptions -> System.Transactions.EnlistmentPublic Function EnlistDurable (resourceManagerIdentifier As Guid, enlistmentNotification As IEnlistmentNotification, enlistmentOptions As EnlistmentOptions) As EnlistmentParamètres
- resourceManagerIdentifier
- Guid
Identificateur unique pour un gestionnaire de ressources qui doit persister pendant une défaillance du gestionnaire de ressources ou un redémarrage.
- enlistmentNotification
- IEnlistmentNotification
Objet qui implémente l'interface IEnlistmentNotification pour recevoir des notifications de validation à deux phases.
- enlistmentOptions
- EnlistmentOptions
EnlistDuringPrepareRequired si le gestionnaire de ressources souhaite exécuter un travail supplémentaire pendant la phase de préparation.
Retours
Un objet Enlistment qui décrit l'inscription.
Remarques
Les gestionnaires de ressources disposant d’un enrôlement durable doivent être en mesure d’effectuer une récupération en cas de défaillance. Pour plus d’informations sur la récupération, consultez Exécution de la récupération. Pour plus d’informations sur les ressources volatiles et durables, ainsi que sur l’inscription d’une ressource, consultez Implémentation d’un Resource Manager. Pour plus d’informations sur la façon dont un gestionnaire de ressources répond à la notification de validation et prépare la validation en deux phases, consultez Commiting A Transaction In Single-Phase and Multi-Phase.
Les gestionnaires de ressources inscrits pour participer à une transaction par le biais de cette méthode reçoivent des notifications de validation en deux phases qui correspondent aux méthodes définies sur l’interface IEnlistmentNotification .
S’applique à
EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)
- Source:
- Transaction.cs
- Source:
- Transaction.cs
- Source:
- Transaction.cs
Inscrit un gestionnaire de ressources durable qui prend en charge l'optimisation de la validation à phase unique pour participer à une transaction.
public:
System::Transactions::Enlistment ^ EnlistDurable(Guid resourceManagerIdentifier, System::Transactions::ISinglePhaseNotification ^ singlePhaseNotification, System::Transactions::EnlistmentOptions enlistmentOptions);public System.Transactions.Enlistment EnlistDurable (Guid resourceManagerIdentifier, System.Transactions.ISinglePhaseNotification singlePhaseNotification, System.Transactions.EnlistmentOptions enlistmentOptions);member this.EnlistDurable : Guid * System.Transactions.ISinglePhaseNotification * System.Transactions.EnlistmentOptions -> System.Transactions.EnlistmentPublic Function EnlistDurable (resourceManagerIdentifier As Guid, singlePhaseNotification As ISinglePhaseNotification, enlistmentOptions As EnlistmentOptions) As EnlistmentParamètres
- resourceManagerIdentifier
- Guid
Identificateur unique pour un gestionnaire de ressources qui doit persister pendant une défaillance du gestionnaire de ressources ou un redémarrage.
- singlePhaseNotification
- ISinglePhaseNotification
Objet qui implémente l'interface ISinglePhaseNotification qui doit être capable de recevoir une validation à phase unique et des notifications de validation à deux phases.
- enlistmentOptions
- EnlistmentOptions
EnlistDuringPrepareRequired si le gestionnaire de ressources souhaite exécuter un travail supplémentaire pendant la phase de préparation.
Retours
Un objet Enlistment qui décrit l'inscription.
Remarques
Les gestionnaires de ressources disposant d’un enrôlement durable doivent être en mesure d’effectuer une récupération en cas de défaillance. Pour plus d’informations sur la récupération, consultez Exécution de la récupération. Pour plus d’informations sur les ressources volatiles et durables, ainsi que sur l’inscription d’une ressource, consultez Implémentation d’un Resource Manager.
Notez que même lorsque votre implémentation de Resource Manager s’inscrit avec cette méthode, il n’est pas garanti qu’elle reçoit une validation en une seule phase. Le gestionnaire de transactions peut toujours envoyer des notifications de validation en deux phases à la place. Pour plus d’informations sur l’optimisation de la validation monophase, consultez Optimisation à l’aide de la validation unique et Notification de phase unique promotable.
