OdbcConnection.EnlistDistributedTransaction(ITransaction) メソッド

定義

名前空間:

System.Data.Odbc

アセンブリ:

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 への参照。

注釈

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

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

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