SqlConnection.EnlistDistributedTransaction(ITransaction) メソッド

定義

名前空間:
System.Data.SqlClient
アセンブリ:
System.Data.dll

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

public:
 void EnlistDistributedTransaction(System::EnterpriseServices::ITransaction ^ transaction);
public void EnlistDistributedTransaction(System.EnterpriseServices.ITransaction transaction);
member this.EnlistDistributedTransaction : System.EnterpriseServices.ITransaction -> unit
Public Sub EnlistDistributedTransaction (transaction As ITransaction)

パラメーター

transaction
ITransaction

参加する既存の ITransaction への参照。

注釈

EnlistTransaction メソッドを使用して、分散トランザクションに参加できます。 Transaction インスタンスに接続を参加させるので、EnlistTransaction は分散トランザクションを管理するために System.Transactions 名前空間で使用できる機能を利用するため、この目的のために EnlistDistributedTransaction を使用することをお勧めします。 詳細については、「 分散トランザクション」を参照してください。

自動参加が無効になっている場合は、 EnlistDistributedTransaction メソッドを使用して、既存の分散トランザクションに引き続き参加できます。 既存の分散トランザクションに参加すると、トランザクションがコミットまたはロールバックされた場合、データ ソースのコードによって行われた変更もコミットまたはロールバックされます。

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

適用対象

こちらもご覧ください