Transaction.EnlistPromotableSinglePhase 方法

定义

命名空间:

System.Transactions

程序集:

System.Transactions.Local.dll

使用可提升的单阶段登记（PSPE）登记具有内部事务的资源管理器。

重载

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)	使用可提升的单阶段登记（PSPE）登记具有内部事务的资源管理器。
EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)	使用可提升的单阶段登记（PSPE）登记具有内部事务的资源管理器。

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)

Source:

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)

Source:

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 对象的序列化