Transaction.EnlistPromotableSinglePhase Метод

Определение

Пространство имен:

System.Transactions

Сборка:

System.Transactions.Local.dll

Заверяет диспетчер ресурсов, имеющий внутреннюю транзакцию с помощью промотабельного однофазного перечисления (PSPE).

Перегрузки

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)	Заверяет диспетчер ресурсов, имеющий внутреннюю транзакцию с помощью промотабельного однофазного перечисления (PSPE).
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)	Заверяет диспетчер ресурсов, имеющий внутреннюю транзакцию с помощью промотабельного однофазного перечисления (PSPE).

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)

Исходный код:

Transaction.cs

Заверяет диспетчер ресурсов, имеющий внутреннюю транзакцию с помощью промотабельного однофазного перечисления (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

Параметры

promotableSinglePhaseNotification

IPromotableSinglePhaseNotification

Интерфейс IPromotableSinglePhaseNotification, реализованный участником.

Возвращаемое значение

Boolean

Реализация интерфейса SinglePhaseEnlistment, описывающая перечисление.

Комментарии

Перечисления в транзакции являются переменными; т. е. они не выжили неудачу участника. Кроме того, этот метод предполагает только диспетчер транзакций для эскалации контроля, но сама эскалация не гарантируется. Если эскалация завершается сбоем, пользователь не уведомляется, а транзакция откатится.

Параметр promotableSinglePhaseNotification используется для обмена данными с диспетчером транзакций в результате попытки фиксации внутренней транзакции диспетчера ресурсов. Если сообщается о несогласованных данных, диспетчер транзакций создает исключение. Если сообщается о результатах InDoubt, диспетчер транзакций ищет уведомление о результатах в собственном внутреннем перечислении и игнорирует сообщаемый ответ.

Дополнительные сведения о зачислении и эскалации транзакции см. в эскалации управления транзакциями. Дополнительные сведения о PSPE см. в разделе оптимизации с помощью однофазной фиксации и уведомления с одним этапом,.

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)

Исходный код:

Transaction.cs

Заверяет диспетчер ресурсов, имеющий внутреннюю транзакцию с помощью промотабельного однофазного перечисления (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

Параметры

promotableSinglePhaseNotification

IPromotableSinglePhaseNotification

Интерфейс IPromotableSinglePhaseNotification, реализованный участником.

promoterType

Guid

Тип обработчика распределенных транзакций.

Возвращаемое значение

Boolean

Реализация интерфейса SinglePhaseEnlistment, описывающая перечисление.

Комментарии

Если значение, указанное для параметра , , транзакция должна быть повышена MSDTC, а , возвращаемая методом , должна быть маркером распространения транзакций MSDTC.

Если значение, указанное для параметра promoterType, неTransactionInterop.PromoterTypeDTC, транзакция не будет повышена MSDTC, а не реализацией вызывающего IPromotableSinglePhaseNotification. Если этот вызов выполнен успешно, существует набор последующих операций с транзакцией, возвращающих TransactionPromotionException. Ниже приведены следующие операции.

• Transaction.EnlistDurable

• TransactionInterop.GetDtcTransaction

• TransactionInterop.GetExportCookie

• TransactionInterop.GetTransmitterPropagationToken

• Сериализация объекта Transaction