次の方法で共有


Transaction.EnlistPromotableSinglePhase メソッド

定義

昇格可能な単一フェーズ参加リスト (PSPE) を使用して、内部トランザクションを持つリソース マネージャーを参加させます。

オーバーロード

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)

昇格可能な単一フェーズ参加リスト (PSPE) を使用して、内部トランザクションを持つリソース マネージャーを参加させます。

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)

昇格可能な単一フェーズ参加リスト (PSPE) を使用して、内部トランザクションを持つリソース マネージャーを参加させます。

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification)

ソース:
Transaction.cs
ソース:
Transaction.cs
ソース:
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 インターフェイス。

戻り値

参加リストを記述する SinglePhaseEnlistment インターフェイスの実装。

注釈

トランザクション内の参加は揮発性です。つまり、参加者の失敗は生き残りません。 さらに、この方法では、トランザクション マネージャーが制御をエスカレートすることのみが提案されますが、エスカレーション自体は保証されません。 エスカレーションが失敗した場合、ユーザーに通知されず、トランザクションがロールバックされます。

パラメーター promotableSinglePhaseNotification は、リソース マネージャーの内部トランザクションをコミットしようとした結果をトランザクション マネージャーに伝えるために使用されます。 不整合なデータが報告されると、トランザクション マネージャーは例外をスローします。 InDoubt 結果が報告された場合、トランザクション マネージャーは独自の内部参加リストで結果通知を検索し、報告された応答を無視します。

トランザクションの参加とエスカレーションの詳細については、「トランザクション管理エスカレーション」を参照してください。 PSPE の詳細については、「単一フェーズ コミットと昇格可能な単一フェーズ通知を使用した 最適化」を参照してください。

適用対象

EnlistPromotableSinglePhase(IPromotableSinglePhaseNotification, Guid)

ソース:
Transaction.cs
ソース:
Transaction.cs
ソース:
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

分散トランザクション プロセッサの種類。

戻り値

参加リストを記述する SinglePhaseEnlistment インターフェイスの実装。

注釈

promoterType パラメーターに指定された値が TransactionInterop.PromoterTypeDtcの場合、トランザクション は MSDTC によって昇格 必要があり、IPromotableSinglePhaseNotification.Promote メソッドから返される byte[]は MSDTC トランザクション伝達トークン 必要があります。

promoterType パラメーターに指定された値が TransactionInterop.PromoterTypeDTCされていない場合、トランザクションは MSDTC ではなく、呼び出し元による IPromotableSinglePhaseNotificationの実装によって昇格されます。 この呼び出しが成功した場合は、トランザクションに対して一連の後続の操作が実行され、TransactionPromotionExceptionが返されます。 これらの操作は次のとおりです。

  • Transaction.EnlistDurable

  • TransactionInterop.GetDtcTransaction

  • TransactionInterop.GetExportCookie

  • TransactionInterop.GetTransmitterPropagationToken

  • Transaction オブジェクトのシリアル化

適用対象