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 インターフェイスの実装。

注釈

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

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

• Transaction.EnlistDurable

• TransactionInterop.GetDtcTransaction

• TransactionInterop.GetExportCookie

• TransactionInterop.GetTransmitterPropagationToken

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