IPromotableSinglePhaseNotification インターフェイス

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

IPromotableSinglePhaseNotification インターフェイス

メモ : このインターフェイスは、.NET Framework version 2.0 で新しく追加されたものです。

リソース マネージャ内部の非分散トランザクションのコミット デリゲートとして機能するオブジェクトを示します。

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

Visual Basic (宣言)

Public Interface IPromotableSinglePhaseNotification
    Inherits ITransactionPromoter

Visual Basic (使用法)

Dim instance As IPromotableSinglePhaseNotification

C#

public interface IPromotableSinglePhaseNotification : ITransactionPromoter

C++

public interface class IPromotableSinglePhaseNotification
 : ITransactionPromoter

J#

public interface IPromotableSinglePhaseNotification extends ITransactionPromoter

JScript

public interface IPromotableSinglePhaseNotification extends
 ITransactionPromoter

解説

昇格可能参加リスト (PSPE: Promotable Enlistments) を使用すると、リソース (データベースなど) がトランザクションに参加している唯一のエンティティである場合、そのリソースがトランザクションの所有権を取得できます。System.Transactions インフラストラクチャは、後から必要に応じて、引き続きトランザクションを Microsoft 分散トランザクション コーディネータ (MSDTC) にエスカレートできます。詳細については、「単一フェーズ コミットと昇格可能な単一フェーズ通知を使用した最適化」を参照してください。

このインターフェイスを実装するリソース マネージャは、Transaction クラスの EnlistPromotableSinglePhase メソッドを介して、リソース マネージャ内部の非分散トランザクションのコミットの制御を、System.Transactions トランザクションの参加リストに処理させます。

ITransactionPromoter.Promote メソッドが呼び出されると、このインターフェイスの実装は分散トランザクションを反映トークンの形式で生成し、System.Transactions に返す必要があります。

EnlistPromotableSinglePhase を使用して、このインターフェイスを実装するオブジェクトをトランザクションの参加要素として追加すると、トランザクション マネージャは、オブジェクトのPromote、SinglePhaseCommit、または Rollback の各メソッドを呼び出すことによって、トランザクションがいつ昇格、コミット、またはロールバックされるかを参加要素に対して通知します。

詳細については、「単一フェーズ コミットと昇格可能な単一フェーズ通知を使用した最適化」を参照してください。

プラットフォーム

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

参照

関連項目
IPromotableSinglePhaseNotification メンバ
System.Transactions 名前空間
Transaction
その他の技術情報
単一フェーズ コミットと昇格可能な単一フェーズ通知を使用した最適化