SqlConnection.EnlistDistributedTransaction(ITransaction) メソッド

定義

名前空間:

Microsoft.Data.SqlClient

アセンブリ:

Microsoft.Data.SqlClient.dll

パッケージ:

Microsoft.Data.SqlClient v5.2.0

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

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