SqlConnection.EnlistDistributedTransaction メソッド

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

SqlConnection.EnlistDistributedTransaction メソッド

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

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

Visual Basic (宣言)

Public Sub EnlistDistributedTransaction ( _
    transaction As ITransaction _
)

Visual Basic (使用法)

Dim instance As SqlConnection
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 メソッドを使用して、既存の分散トランザクションの登録を続行できます。既存の分散トランザクションに参加すると、トランザクションがコミットまたはロールバックされたときに、データ ソース側のコードで変更された内容もコミットまたはロールバックされます。

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

参照

関連項目
SqlConnection クラス
SqlConnection メンバ
System.Data.SqlClient 名前空間
その他の技術情報
トランザクションの実行
分散トランザクションの実行
System.Transactions の活用
ADO.NET でのデータへの接続およびデータの取得
.NET Framework Data Provider for SQL Server の使用