Cette documentation est archivée et n’est pas conservée.

IEnlistmentNotification.Prepare, méthode

Remarque : cette méthode est nouvelle dans le .NET Framework version 2.0.

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

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

void Prepare (
	PreparingEnlistment preparingEnlistment
)
void Prepare (
	PreparingEnlistment preparingEnlistment
)
function Prepare (
	preparingEnlistment : PreparingEnlistment
)

Paramètres

preparingEnlistment

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

Le gestionnaire de transactions appelle cette méthode d'un gestionnaire de ressources inscrit pendant la phase 1 d'une validation 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 pendant cette phase. L'enregistrement doit contenir toutes les informations nécessaires pour effectuer la récupération. Cela inclut la propriété RecoveryInformation, qui est passée au gestionnaire de transactions dans la méthode Reenlist pendant la récupération. Pour plus d'informations sur la récupération, consultez Réalisation d'une restauration.

Votre gestionnaire de ressources doit s'acquitter de tout le travail qui doit être fini avant d'appeler la méthode Prepared du paramètre preparingEnlistment pour indiquer son vote pour la validation. Vous devez vous assurer que cela est effectué avant de recevoir toute notification de phase 2 telle que la validation, la restauration ou la mise en doute. En effet, les notifications de phase 2 peuvent se produire en ligne sur le même thread qui a appelé la méthode Prepared en phase 1. Par conséquent, vous ne devez effectuer aucun travail après l'appel Prepared (par exemple, une libération de verrouillages) que vous devez avoir terminé avant de recevoir les notifications de phase 2.

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

Si vous souhaitez que l'objet observe et réagisse simplement à la progression de la transaction, sans y participer, votre implémentation de cette méthode doit appeler la méthode Done du paramètre preparingEnlistment lorsqu'elle a fini son travail. En procédant ainsi, votre gestionnaire de ressources ne doit pas recevoir de notification de phase 2.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: