IEnlistmentNotification.Prepare(PreparingEnlistment) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Upozorní zařazený objekt, že transakce je připravována k závazku.
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)
Parametry
- preparingEnlistment
- PreparingEnlistment
Objekt PreparingEnlistment slouží k odeslání odpovědi do správce transakcí.
Poznámky
Správce transakcí volá tuto metodu zařazení správce prostředků během fáze 1 závazku, když se zeptá účastníků, zda mohou potvrdit transakci.
Při implementaci správce trvalých prostředků byste měli protokolovat přípravný záznam během této fáze. Záznam by měl obsahovat všechny informace potřebné k obnovení. To zahrnuje RecoveryInformation vlastnost, která je předána správci transakcí v Reenlist metodě během obnovení. Další informace o obnovení najdete v tématu Provádění obnovení.
Správce prostředků by měl dokončit veškerou práci, která musí být dokončena před voláním Prepared metody parametru preparingEnlistment
k označení jeho hlasu pro závazek. Před obdržením oznámení fáze 2, jako je potvrzení, vrácení zpět nebo pochybnosti, byste se měli ujistit, že je to splněné. Důvodem je to, že oznámení fáze 2 mohou být vložena ve stejném vlákně, které volal metodu Prepared ve fázi 1. Jako takové neměli byste každé dílo po Prepared volání (například uvolňující uzamčení), které očekáváte dokončili před přijímala oznámení fáze 2.
Můžete také volat metodu parametru preparingEnlistment
a označit tak hlasování o vrácení zpět.
Chcete-li objekt pouze sledovat a reagovat na průběh transakce, aniž by se účastní, implementace této metody by měla volat Done metodu parametru preparingEnlistment
po dokončení své práce. Správce prostředků by tak neobdržel žádné oznámení fáze 2.