SqlConnection.EnlistTransaction(Transaction) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Enlists in the specified transaction as a distributed transaction.
public:
override void EnlistTransaction(System::Transactions::Transaction ^ transaction);public override void EnlistTransaction(System.Transactions.Transaction transaction);override this.EnlistTransaction : System.Transactions.Transaction -> unitPublic Overrides Sub EnlistTransaction (transaction As Transaction)Parameters
- transaction
- Transaction
A reference to an existing Transaction in which to enlist.
Remarks
You can use the EnlistTransaction(Transaction) method to enlist in a distributed transaction. Because it enlists a connection in a Transaction instance, EnlistTransaction(Transaction) takes advantage of functionality available in the System.Transactions namespace for managing distributed transactions, making it preferable to EnlistDistributedTransaction(ITransaction), which uses a ITransaction object (from System.EnterpriseServices namespace). It also has slightly different semantics: once a connection is explicitly enlisted on a transaction, it cannot be unenlisted or enlisted in another transaction until the first transaction finishes. For more information about distributed transactions, see Distributed Transactions.