OleDbConnection.EnlistDistributedTransaction メソッド

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

OleDbConnection.EnlistDistributedTransaction メソッド

指定した分散トランザクションに参加します。

名前空間: System.Data.OleDb
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Sub EnlistDistributedTransaction ( _
    transaction As ITransaction _
)

Visual Basic (使用法)

Dim instance As OleDbConnection
Dim transaction As ITransaction

instance.EnlistDistributedTransaction(transaction)

C#

public void EnlistDistributedTransaction (
    ITransaction transaction
)

C++

public:
void EnlistDistributedTransaction (
    ITransaction^ transaction
)

J#

public void EnlistDistributedTransaction (
    ITransaction transaction
)

JScript

public function EnlistDistributedTransaction
 (
    transaction : ITransaction
)

パラメータ

transaction

登録先の既存の ITransaction への参照。

解説

ADO.NET 2.0 では、分散トランザクションに登録するための EnlistTransaction メソッドの使用のサポートが新しく追加されました。Transaction インスタンスに接続を登録する EnlistTransaction は、System.Transactions 名前空間で利用できる機能を分散トランザクションの管理用に利用して、この目的のために EnlistDistributedTransaction に合うようにします。詳細については、「分散トランザクションの実行」を参照してください。

自動登録が無効になっている場合、EnlistDistributedTransaction メソッドを使用して、既存の分散トランザクションの登録を続行できます。既存の分散トランザクションに参加すると、トランザクションがコミットまたはロールバックされたときに、データ ソース側のコードで変更された内容もコミットまたはロールバックされます。分散トランザクションの詳細については、「分散トランザクションの実行」を参照してください。

OleDbConnection が BeginTransaction を使用して既にトランザクションを開始している場合、EnlistDistributedTransaction は例外を返します。ただし、開始されているトランザクションがデータ ソースで開始されたローカル トランザクションである場合 (たとえば、OleDbCommand オブジェクトを使用して明示的に BEGIN TRANSACTION ステートメントを実行した場合など)、EnlistDistributedTransaction は、ローカル トランザクションをロール バックし、要求された既存の分散トランザクションを登録します。ローカル トランザクションがロール バックされたことは通知されません。開発者は、BeginTransaction を使用して開始されていないローカル トランザクションを管理する必要があります。

プラットフォーム

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、1.1

参照

関連項目
OleDbConnection クラス
OleDbConnection メンバ
System.Data.OleDb 名前空間
その他の技術情報
データ ソースへの接続