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 potvrzení jedné fáze pro účast v 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 potvrzení jedné fáze, není zaručeno, že obdrží jednofázové potvrzení. Správce transakcí může místo toho odesílat oznámení o dvoufázových potvrzeních.
Chcete-li zahrnout správce prostředků jako účastníka transakce, zavolejte EnlistVolatile metodu nebo EnlistDurable metodu Transaction třídy. Konkrétně EnlistmentOptions by se měl parametr rovnat None , aby se zajistilo, že se provede jednofázové potvrzení. Pokud je omylem nastavena na EnlistDuringPrepareRequired, nedojde k žádnému potvrzení jedné fáze.
Vzhledem k tomu, že ISinglePhaseNotification rozhraní je odvozeno z IEnlistmentNotification rozhraní, správce prostředků musí také implementovat všechny metody druhé pro dvě fáze 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í však dává správci prostředků příležitost využít optimalizaci, pokud je k dispozici.
Pokud se používá optimalizace a správce transakcí volá SinglePhaseCommit metodu zařazeného prostředku, správce prostředků by měl reagovat na toto volání pomocí různých metod SinglePhaseEnlistment třídy informovat správce transakcí, pokud je transakce potvrzena nebo vrácena zpět.
Metody
| Name | Description |
|---|---|
| Commit(Enlistment) |
Upozorní zařazený objekt, že transakce je potvrzena. (Zděděno od IEnlistmentNotification) |
| InDoubt(Enlistment) |
Upozorní zařazený objekt, že stav transakce je pochybnosti. (Zděděno od IEnlistmentNotification) |
| Prepare(PreparingEnlistment) |
Upozorní zařazený objekt, že transakce je připravena na závazek. (Zděděno od IEnlistmentNotification) |
| Rollback(Enlistment) |
Upozorní na zařazený objekt, že transakce se vrací zpět (přerušeno). (Zděděno od IEnlistmentNotification) |
| SinglePhaseCommit(SinglePhaseEnlistment) |
Představuje implementaci zpětného volání správce prostředků pro optimalizaci potvrzení jedné fáze. |
