SqlConnection.EnlistDistributedTransaction(ITransaction) メソッド

定義

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

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 使用して、分散トランザクションに参加できます。 インスタンスに接続を参加させるので TransactionEnlistTransaction は分散トランザクションを管理するために名前空間で System.Transactions 使用できる機能を利用するため、この目的で EnlistDistributedTransaction を使用することをお勧めします。 詳細については、分散トランザクションに関する記事を参照してください。

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

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

適用対象

こちらもご覧ください