EnlistTransaction Method

In This Topic

Enlists in the specified transaction.

Syntax

Visual Basic
C#

'Declaration
 
Public Overrides Sub EnlistTransaction( _
   ByVal transaction As Transaction _
)

public override void EnlistTransaction( 
   Transaction transaction
)

Parameters

transaction: A reference to an existing System.Transactions.Transaction in which to enlist.

Remarks

Once a connection is explicitly enlisted in a distributed transaction, it cannot be unenlisted or enlisted in another transaction until the first transaction finishes.

Example

These samples demonstrate usage of EnlistTransaction.

csharp

FreshBooksCommand1.Connection=FreshBooksConnection1;
using (TransactionScope transScope = new TransactionScope()) {
 FreshBooksConnection1.Open();
 FreshBooksCommand1.ExecuteNonQuery();
 transScope.Complete();
}
FreshBooksConnection1.Close();

- or -

FreshBooksCommand1.Connection=FreshBooksConnection1;
FreshBooksConnection1.Open();
using (TransactionScope transScope = new TransactionScope()) {
 FreshBooksConnection1.EnlistTransaction(Transaction.Current);
 FreshBooksCommand1.ExecuteNonQuery();
 transScope.Complete();
}
FreshBooksConnection1.Close();

- or -

CommittableTransaction cmtTx = new CommittableTransaction();
FreshBooksConnection1.Open();
FreshBooksConnection1.EnlistTransaction(cmtTx);
FreshBooksCommand1.ExecuteNonQuery();
FreshBooksConnection1.Close();

Visual Basic

Me.FreshBooksCommand1.Connection = Me.FreshBooksConnection1
Using transScope = New Transactions.TransactionScope
  Me.FreshBooksConnection1.Open()
  Me.FreshBooksCommand1.ExecuteNonQuery()
  transScope.Complete()
End Using
Me.FreshBooksConnection1.Close()

- or -

Me.FreshBooksCommand1.Connection = Me.FreshBooksConnection1
Me.FreshBooksConnection1.Open()
Using transScope = New Transactions.TransactionScope
  Me.FreshBooksConnection1.EnlistTransaction(Transactions.Transaction.Current)
  Me.FreshBooksCommand1.ExecuteNonQuery()
  transScope.Complete()
End Using
Me.FreshBooksConnection1.Close()

- or -

Dim cmtTx As New Transactions.CommittableTransaction
Me.FreshBooksConnection1.Open()
Me.FreshBooksConnection1.EnlistTransaction(cmtTx)
Me.FreshBooksCommand1.ExecuteNonQuery()
Me.FreshBooksConnection1.Close()

Reference

DbConnectionBase Class
DbConnectionBase Members

Send Feedback