Transaction.EnlistPromotableSinglePhase Metoda

Definicja

Przestrzeń nazw:

System.Transactions

Zestaw:

System.Transactions.Local.dll

Enlists a resource manager, który ma transakcję wewnętrzną przy użyciu promotable pojedynczej fazy rejestracji (PSPE).

Przeciążenia

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)	Enlists a resource manager, który ma transakcję wewnętrzną przy użyciu promotable pojedynczej fazy rejestracji (PSPE).
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)	Enlists a resource manager, który ma transakcję wewnętrzną przy użyciu promotable pojedynczej fazy rejestracji (PSPE).

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)

Źródło:

Transaction.cs

Enlists a resource manager, który ma transakcję wewnętrzną przy użyciu promotable pojedynczej fazy rejestracji (PSPE).

public:
 bool EnlistPromotableSinglePhase(System::Transactions::IPromotableSinglePhaseNotification ^ promotableSinglePhaseNotification);

public bool EnlistPromotableSinglePhase (System.Transactions.IPromotableSinglePhaseNotification promotableSinglePhaseNotification);

member this.EnlistPromotableSinglePhase : System.Transactions.IPromotableSinglePhaseNotification -> bool

Public Function EnlistPromotableSinglePhase (promotableSinglePhaseNotification As IPromotableSinglePhaseNotification) As Boolean

Parametry

promotableSinglePhaseNotification

IPromotableSinglePhaseNotification

Interfejs IPromotableSinglePhaseNotification zaimplementowany przez uczestnika.

Zwraca

Boolean

Implementacja interfejsu SinglePhaseEnlistment opisujący rejestrację.

Uwagi

Rejestracje w transakcji są nietrwałe; oznacza to, że nie przetrwają porażki uczestnika. Ponadto ta metoda sugeruje tylko menedżera transakcji eskalacji kontroli, ale sama eskalacja nie jest gwarantowana. Jeśli eskalacja nie powiedzie się, użytkownik zostanie powiadomiony i transakcja zostanie wycofana.

Parametr promotableSinglePhaseNotification służy do przekazywania menedżerowi transakcji wyniku próby zatwierdzenia transakcji wewnętrznej transakcji menedżera zasobów. W przypadku zgłaszania niespójnych danych menedżer transakcji zgłasza wyjątek. Jeśli zostanie zgłoszony wynik InDoubt, menedżer transakcji szuka powiadomienia o wyniku we własnym wewnętrznym rejestracji i ignoruje zgłoszoną odpowiedź.

Aby uzyskać więcej informacji na temat rejestracji i eskalacji transakcji, zobacz Eskalacja zarządzania transakcjami. Aby uzyskać więcej informacji na temat PSPE, zobacz Optymalizacja przy użyciu zatwierdzania jednofazowego i promotable Single Phase Notification.

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)

Źródło:

Transaction.cs

Enlists a resource manager, który ma transakcję wewnętrzną przy użyciu promotable pojedynczej fazy rejestracji (PSPE).

public:
 bool EnlistPromotableSinglePhase(System::Transactions::IPromotableSinglePhaseNotification ^ promotableSinglePhaseNotification, Guid promoterType);

public bool EnlistPromotableSinglePhase (System.Transactions.IPromotableSinglePhaseNotification promotableSinglePhaseNotification, Guid promoterType);

member this.EnlistPromotableSinglePhase : System.Transactions.IPromotableSinglePhaseNotification * Guid -> bool

Public Function EnlistPromotableSinglePhase (promotableSinglePhaseNotification As IPromotableSinglePhaseNotification, promoterType As Guid) As Boolean

Parametry

promotableSinglePhaseNotification

IPromotableSinglePhaseNotification

Interfejs IPromotableSinglePhaseNotification zaimplementowany przez uczestnika.

promoterType

Guid

Typ procesora transakcji rozproszonej.

Zwraca

Boolean

Implementacja interfejsu SinglePhaseEnlistment opisujący rejestrację.

Uwagi

Jeśli wartość określona dla parametru jest , transakcji musi być promowana przez MSDTC, a zwrócona z metody musi być tokenem propagacji transakcji MSDTC.

Jeśli wartość określona dla parametru promoterType jest nieTransactionInterop.PromoterTypeDTC, transakcja nie będzie promowana przez MSDTC, ale raczej przez implementację obiektu wywołującego IPromotableSinglePhaseNotification. Jeśli to wywołanie powiedzie się, istnieje zestaw kolejnych operacji na transakcji, która zwróci TransactionPromotionException. Te operacje to:

• Transaction.EnlistDurable

• TransactionInterop.GetDtcTransaction

• TransactionInterop.GetExportCookie

• TransactionInterop.GetTransmitterPropagationToken

• Serializacja obiektu Transaction