Transaction.EnlistPromotableSinglePhase メソッド

.NET Framework クラス ライブラリ リファレンス

Transaction.EnlistPromotableSinglePhase メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

PSPE (Promotable Single Phase Enlistment) を使用して、内部トランザクションを持つリソース マネージャを参加させます。

名前空間: System.Transactions
アセンブリ: System.Transactions (system.transactions.dll 内)
構文

Visual Basic (宣言)

Public Function EnlistPromotableSinglePhase
 ( _
    promotableSinglePhaseNotification As IPromotableSinglePhaseNotification
 _
) As Boolean

Visual Basic (使用法)

Dim instance As Transaction
Dim promotableSinglePhaseNotification As IPromotableSinglePhaseNotification
Dim returnValue As Boolean

returnValue = instance.EnlistPromotableSinglePhase(promotableSinglePhaseNotification)

C#

public bool EnlistPromotableSinglePhase (
    IPromotableSinglePhaseNotification promotableSinglePhaseNotification
)

C++

public:
bool EnlistPromotableSinglePhase (
    IPromotableSinglePhaseNotification^ promotableSinglePhaseNotification
)

J#

public boolean EnlistPromotableSinglePhase (
    IPromotableSinglePhaseNotification promotableSinglePhaseNotification
)

JScript

public function EnlistPromotableSinglePhase
 (
    promotableSinglePhaseNotification : IPromotableSinglePhaseNotification
) : boolean

パラメータ

promotableSinglePhaseNotification

参加要素が実装する IPromotableSinglePhaseNotification インターフェイス。

戻り値
参加リストを示す SinglePhaseEnlistment インターフェイスの実装。

解説

トランザクションの参加リストは揮発性です。つまり、参加リストには参加要素のエラーは保持されません。また、このメソッドでは、トランザクション マネージャだけが制御をエスカレートすることが推奨されますが、エスカレーション自体が保証されるわけではありません。エスカレーションが失敗した場合、ユーザーには通知されず、トランザクションはロールバックされます。

promotableSinglePhaseNotification パラメータを使用して、リソース マネージャの内部トランザクションのコミットを試みた結果をトランザクション マネージャに伝達します。一貫性のないデータが報告された場合、トランザクション マネージャは例外をスローします。InDoubt の結果が報告されると、トランザクション マネージャはその内部参加リストで結果通知を検索し、報告された応答を無視します。

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

メモ   このメソッドは、LinkDemand を使用して信頼関係のないコードからの呼び出しを防ぎます。ただし、FullTrust アクセス許可セットを保持する必要があるのは、直前の呼び出し元だけです。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Transaction クラス
Transaction メンバ
System.Transactions 名前空間