ISinglePhaseNotification

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

ISinglePhaseNotification インターフェイス

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

トランザクションに参加するための単一フェーズ コミットの最適化をサポートするリソース オブジェクトを示します。

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

Visual Basic (宣言)

Public Interface ISinglePhaseNotification
    Inherits IEnlistmentNotification

Visual Basic (使用法)

Dim instance As ISinglePhaseNotification

C#

public interface ISinglePhaseNotification : IEnlistmentNotification

C++

public interface class ISinglePhaseNotification
 : IEnlistmentNotification

J#

public interface ISinglePhaseNotification extends IEnlistmentNotification

JScript

public interface ISinglePhaseNotification extends
 IEnlistmentNotification

解説

リソース マネージャがこのインターフェイスを実装して単一フェーズ コミットの最適化をサポートしている場合でも、単一フェーズ コミットを受け取るという保証はありません。その場合でもトランザクション マネージャは、単一フェーズ コミットではなく 2 フェーズ コミットの通知を送信する場合があります。単一フェーズ コミットの最適化の詳細については、「単一フェーズ コミットと昇格可能な単一フェーズ通知を使用した最適化」を参照してください。

リソース マネージャをトランザクションの参加要素として参加させるには、Transaction クラスの EnlistVolatile メソッドまたは EnlistDurable メソッドを呼び出します。特に、確実に単一フェーズ コミットを実行するには、EnlistmentOptions パラメータを None と同じにする必要があります。誤って EnlistDuringPrepareRequired に設定すると、単一フェーズ コミットは実行されません。

ISinglePhaseNotification インターフェイスは IEnlistmentNotification インターフェイスから派生しているため、2 フェーズ コミットの通知を行うためには、リソース マネージャが IEnlistmentNotification インターフェイスのメソッドをすべて実装する必要もあります。このリソース マネージャで 2 フェーズ コミットを使用するか単一フェーズ コミットの最適化を使用するかは、トランザクション マネージャが選択します。ただし、このインターフェイスを実装すると、リソース マネージャで最適化を使用できます (使用できる場合)。

最適化を使用し、トランザクション マネージャが参加リソースの SinglePhaseCommit メソッドを呼び出すと、リソース マネージャは SinglePhaseEnlistment クラスのさまざまなメソッドを使用してこの呼び出しに応答し、トランザクションをコミットするかロールバックするかをトランザクション マネージャに通知します。

プラットフォーム

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

参照

関連項目
ISinglePhaseNotification メンバ
System.Transactions 名前空間
IEnlistmentNotification インターフェイス
その他の技術情報
トランザクションへの参加要素としてのリソースの登録
単一フェーズおよびマルチフェーズでのトランザクションのコミット

ISinglePhaseNotification メソッド

パブリック メソッド

	名前	説明
	SinglePhaseCommit	単一フェーズ コミットの最適化に対応したリソース マネージャにおけるコールバックの実装を表します。

参照

関連項目

ISinglePhaseNotification インターフェイス
System.Transactions 名前空間
IEnlistmentNotification インターフェイス

その他の技術情報

トランザクションへの参加要素としてのリソースの登録
単一フェーズおよびマルチフェーズでのトランザクションのコミット

ISinglePhaseNotification メンバ

トランザクションに参加するための単一フェーズ コミットの最適化をサポートするリソース オブジェクトを示します。

ISinglePhaseNotification データ型で公開されるメンバを以下の表に示します。

パブリック メソッド

	名前	説明
	SinglePhaseCommit	単一フェーズ コミットの最適化に対応したリソース マネージャにおけるコールバックの実装を表します。

参照

関連項目

ISinglePhaseNotification インターフェイス
System.Transactions 名前空間
IEnlistmentNotification インターフェイス

その他の技術情報

トランザクションへの参加要素としてのリソースの登録
単一フェーズおよびマルチフェーズでのトランザクションのコミット