Partager via


IEnlistmentNotification.Prepare(PreparingEnlistment) Méthode

Définition

Avertit un objet inscrit qu'une transaction est en cours de préparation pour validation.

public:
 void Prepare(System::Transactions::PreparingEnlistment ^ preparingEnlistment);
public void Prepare (System.Transactions.PreparingEnlistment preparingEnlistment);
abstract member Prepare : System.Transactions.PreparingEnlistment -> unit
Public Sub Prepare (preparingEnlistment As PreparingEnlistment)

Paramètres

preparingEnlistment
PreparingEnlistment

Objet PreparingEnlistment utilisé pour envoyer une réponse au gestionnaire de transactions.

Remarques

Le gestionnaire de transactions appelle cette méthode d’un gestionnaire de ressources inscrit pendant la phase 1 d’un engagement, lorsqu’il demande aux participants s’ils peuvent valider la transaction.

Lorsque vous implémentez un gestionnaire de ressources durable, vous devez enregistrer votre enregistrement de préparation au cours de cette phase. L’enregistrement doit contenir toutes les informations nécessaires pour effectuer la récupération. Cela inclut la RecoveryInformation propriété, qui est passée au gestionnaire de transactions dans la méthode pendant la Reenlist récupération. Pour plus d’informations sur la récupération, consultez Exécution de la récupération.

Votre gestionnaire de ressources doit effectuer tous les travaux qui doivent être terminés avant d’appeler la Prepared méthode du preparingEnlistment paramètre pour indiquer son vote pour l’engagement. Vous devez vous assurer que cela est effectué avant de recevoir une notification de phase 2 telle que la validation, la restauration ou le doute. En effet, les notifications de phase 2 peuvent se produire inline sur le thread qui a appelé la méthode dans la Prepared phase 1. Par conséquent, vous ne devez effectuer aucun travail après l'appel Prepared (par exemple, libérer des verrous) que vous devez avoir terminé avant de recevoir les notifications de phase 2.

Vous pouvez également appeler la méthode du preparingEnlistment paramètre pour indiquer un vote pour la restauration.

Si vous souhaitez que l’objet observe simplement la progression de la transaction et y réagisse, sans y participer, votre implémentation de cette méthode doit appeler la Done méthode du preparingEnlistment paramètre lorsqu’elle a terminé son travail. Ce faisant, votre gestionnaire de ressources ne recevrait aucune notification de phase 2.

S’applique à