Sdílet prostřednictvím


ISinglePhaseNotification Rozhraní

Definice

Popisuje objekt prostředku, který podporuje optimalizaci jednofázového potvrzení pro účast na transakci.

public interface class ISinglePhaseNotification : System::Transactions::IEnlistmentNotification
public interface ISinglePhaseNotification : System.Transactions.IEnlistmentNotification
type ISinglePhaseNotification = interface
    interface IEnlistmentNotification
Public 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í.

Platí pro

Viz také