IEnlistmentNotification.Rollback メソッド

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

IEnlistmentNotification.Rollback メソッド

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

トランザクションのロールバック (中止) 中であることを参加オブジェクトに通知します。

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

Visual Basic (宣言)

Sub Rollback ( _
    enlistment As Enlistment _
)

Visual Basic (使用法)

Dim instance As IEnlistmentNotification
Dim enlistment As Enlistment

instance.Rollback(enlistment)

C#

void Rollback (
    Enlistment enlistment
)

C++

void Rollback (
    Enlistment^ enlistment
)

J#

void Rollback (
    Enlistment enlistment
)

JScript

function Rollback (
    enlistment : Enlistment
)

パラメータ

enlistment

トランザクション マネージャに応答を送信するために使用する Enlistment オブジェクト。

解説

トランザクション マネージャは、1 つ以上のトランザクション参加要素がトランザクションをコミットできないために、トランザクションがロールバック (中止) される場合に、参加オブジェクトのこのメソッドを呼び出します。

リソース マネージャは、トランザクションを完了するために必要なすべての作業を実行し、enlistment パラメータでDone メソッドを呼び出すことにより、作業が完了したことをトランザクション マネージャに知らせる必要があります。

リソース マネージャが永続的に参加しても、Done メソッドを呼び出して応答しないと、トランザクション マネージャにはリソース マネージャが Rollback 呼び出しを受け取ったかどうかが認識できません。このため、トランザクション マネージャは応答を待ち続け、このトランザクションに関する情報を保持します。Done が呼び出されない場合、この情報はメモリまたはシステム全体のリソース内にいつまでも保持されます。この結果、リソースを再要求できなくなります。分散トランザクションの場合、これによって MSDTC ログがいっぱいになってしまい、MSDTC プロセスが中断されることがあります。System.Transactions によって管理されるトランザクションの場合、リソース マネージャのプロセスによるメモリ使用量が徐々に増加し続けます。このような理由から、リソース マネージャで準備作業が終了したら Done メソッドを呼び出すことが重要です。

プラットフォーム

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

参照

関連項目
IEnlistmentNotification インターフェイス
IEnlistmentNotification メンバ
System.Transactions 名前空間