Transaction.EnlistDurable Méthode

Définition

Espace de noms:

System.Transactions

Assembly:

System.Transactions.Local.dll

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

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.Enlistment

Public Function EnlistDurable (resourceManagerIdentifier As Guid, enlistmentNotification As IEnlistmentNotification, enlistmentOptions As EnlistmentOptions) As Enlistment

Paramè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

Enlistment

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 .

EnlistDurable(Guid, ISinglePhaseNotification, EnlistmentOptions)

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.Enlistment

Public Function EnlistDurable (resourceManagerIdentifier As Guid, singlePhaseNotification As ISinglePhaseNotification, enlistmentOptions As EnlistmentOptions) As Enlistment

Paramè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

Enlistment

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.