ISinglePhaseNotification Rozhraní
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í.
Popisuje objekt prostředku, který podporuje optimalizaci jednofázového potvrzení pro účast na transakci.
public interface class ISinglePhaseNotification : System::Transactions::IEnlistmentNotificationpublic interface ISinglePhaseNotification : System.Transactions.IEnlistmentNotificationtype ISinglePhaseNotification = interface
interface IEnlistmentNotificationPublic Interface ISinglePhaseNotification
Implements IEnlistmentNotification- Implementuje
Poznámky
Měli byste si uvědomit, že i když správce prostředků implementuje toto rozhraní pro podporu optimalizace jednofázového potvrzení, není zaručeno, že obdrží jednofázové potvrzení. Správce transakcí může místo toho odesílat oznámení o dvoufázovém potvrzení.
Chcete-li zahrnout správce prostředků jako účastníka transakce, zavolejte metodu EnlistVolatile nebo metodu EnlistDurableTransaction třídy. Parametr by se měl konkrétně rovnatNone, EnlistmentOptions aby se zajistilo provedení jednofázového potvrzení. Pokud je omylem nastavena na hodnotu , nedojde k EnlistDuringPrepareRequiredžádnému jednofázovém potvrzení.
Vzhledem k tomu, že ISinglePhaseNotification rozhraní je odvozeno od IEnlistmentNotification rozhraní, musí správce prostředků také implementovat všechny metody druhé pro dvoufázové potvrzení oznámení. Je to volba správce transakcí, zda se s tímto správcem prostředků používá dvoufázové potvrzení nebo optimalizace jednofázového potvrzení. Implementace tohoto rozhraní ale dává správci prostředků možnost využít optimalizaci, pokud je k dispozici.
Pokud je použita optimalizace a správce transakcí volá SinglePhaseCommit metodu prostředku zařazení, měl by správce prostředků odpovědět na toto volání pomocí různých metod SinglePhaseEnlistment třídy informovat správce transakcí, pokud má být transakce potvrzena nebo vrácena zpět.
Metody
| Commit(Enlistment) |
Upozorní objekt zařazený na seznam, že transakce je potvrzena. (Zděděno od IEnlistmentNotification) |
| InDoubt(Enlistment) |
Upozorní objekt zařazení, že stav transakce je v pochybnosti. (Zděděno od IEnlistmentNotification) |
| Prepare(PreparingEnlistment) |
Upozorní objekt zařazený do seznamu, že transakce je připravována k závazku. (Zděděno od IEnlistmentNotification) |
| Rollback(Enlistment) |
Upozorní objekt zařazený do seznamu, že transakce je vrácena zpět (přerušena). (Zděděno od IEnlistmentNotification) |
| SinglePhaseCommit(SinglePhaseEnlistment) |
Představuje implementaci zpětného volání správce prostředků pro optimalizaci jednofázového potvrzení. |
