SqlConnection::EnlistTransaction Method (Transaction^)

 

Enlists in the specified transaction as a distributed transaction.

Namespace:   System.Data.SqlClient
Assembly:  System.Data (in System.Data.dll)

public:
virtual void EnlistTransaction(
	Transaction^ transaction
) override

Parameters

transaction
Type: System.Transactions::Transaction^

A reference to an existing Transaction in which to enlist.

You can use the EnlistTransaction method to enlist in a distributed transaction. Because it enlists a connection in a Transaction instance, EnlistTransaction takes advantage of functionality available in the System.Transactions namespace for managing distributed transactions, making it preferable to EnlistDistributedTransaction, which uses a System.EnterpriseServices.ITransaction object. 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.

.NET Framework
Available since 2.0
Return to top
Show: