Transaction.EnlistPromotableSinglePhase Metoda

Definicja

Przestrzeń nazw:

System.Transactions

Zestaw:

System.Transactions.Local.dll

Zaciąga menedżera zasobów, który ma transakcję wewnętrzną przy użyciu promotable rejestracji jednofazowej (PSPE).

Przeciążenia

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)	Zaciąga menedżera zasobów, który ma transakcję wewnętrzną przy użyciu promotable rejestracji jednofazowej (PSPE).
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)	Zaciąga menedżera zasobów, który ma transakcję wewnętrzną przy użyciu promotable rejestracji jednofazowej (PSPE).

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)

Źródło:

Transaction.cs

Zaciąga menedżera zasobów, który ma transakcję wewnętrzną przy użyciu promotable rejestracji jednofazowej (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 SinglePhaseEnlistment interfejsu opisującą 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. InDoubt Jeśli zostanie zgłoszony wynik, 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 jednofazowego powiadomienia.

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)

Źródło:

Transaction.cs

Zaciąga menedżera zasobów, który ma transakcję wewnętrzną przy użyciu promotable rejestracji jednofazowej (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 rozproszonego procesora transakcji.

Zwraca

Boolean

Implementacja SinglePhaseEnlistment interfejsu opisującą rejestrację.

Uwagi

Jeśli wartość określona dla parametru promoterType to TransactionInterop.PromoterTypeDtc, transakcja musi być promowana przez MSDTC i byte[] zwrócony z IPromotableSinglePhaseNotification.Promote metody musi być token propagacji transakcji MSDTC.

Jeśli wartość określona dla parametru promoterTypenieTransactionInterop.PromoterTypeDTC jest, 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 TransactionPromotionExceptionwartość . Te operacje to:

• Transaction.EnlistDurable

• TransactionInterop.GetDtcTransaction

• TransactionInterop.GetExportCookie

• TransactionInterop.GetTransmitterPropagationToken

• Serializacja obiektu Transaction