OleDbConnection.EnlistDistributedTransaction(ITransaction) Methode

Definition

Trägt sich in der angegebenen Transaktion als verteilte Transaktion ein.Enlists in the specified transaction as a distributed transaction.

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)

Parameter

transaction
ITransaction

Ein Verweis auf eine vorhandene ITransaction, in der die Eintragung vorgenommen werden soll.A reference to an existing ITransaction in which to enlist.

Hinweise

Neu in ADO.NET 2,0 ist die Unterstützung für die Verwendung der EnlistTransaction-Methode zum Eintragen in eine verteilte Transaktion.New in ADO.NET 2.0 is support for using the EnlistTransaction method to enlist in a distributed transaction. Da eine Verbindung in einer Transaction Instanz eingetragen wird, nutzt EnlistTransaction die Funktionalität, die im System.Transactions-Namespace für die Verwaltung verteilter Transaktionen verfügbar ist, sodass Sie EnlistDistributedTransaction vorzuziehen ist. zu diesem Zweck.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 for this purpose. Weitere Informationen finden Sie unter verteilte Transaktionen.For more information, see Distributed Transactions.

Sie können die Eintragung in eine vorhandene verteilte Transaktion mit der EnlistDistributedTransaction-Methode fortsetzen, wenn die automatische Eintragung deaktiviert ist.You can continue to enlist in an existing distributed transaction using the EnlistDistributedTransaction method if auto-enlistment is disabled. Durch das Eintragen in eine vorhandene verteilte Transaktion wird sichergestellt, dass bei einem Commit oder Rollback der Transaktion auch für Änderungen, die vom Code an der Datenquelle vorgenommen werden, ein Commit oder Rollback ausgeführt wird.Enlisting in an existing distributed transaction makes sure that, if the transaction is committed or rolled back, modifications made by the code at the data source are also committed or rolled back. Weitere Informationen zu verteilten Transaktionen finden Sie unter verteilte Transaktionen.For more information about distributed transactions, see Distributed Transactions.

EnlistDistributedTransaction gibt eine Ausnahme zurück, wenn die OleDbConnection eine Transaktion bereits mit BeginTransactiongestartet hat.EnlistDistributedTransaction returns an exception if the OleDbConnection has already started a transaction using BeginTransaction. Wenn es sich bei der Transaktion jedoch um eine lokale Transaktion handelt, die in der Datenquelle gestartet wurde (z. b. durch explizites Ausführen der BEGIN TRANSACTION Anweisung mit einem OleDbCommand-Objekt), führt EnlistDistributedTransaction ein Rollback der lokalen Transaktion aus und trägt in die vorhandene verteilte Transaktion wie angefordert.However, if the transaction is a local transaction started at the data source (for example, by explicitly executing the BEGIN TRANSACTION statement using an OleDbCommand object), EnlistDistributedTransaction rolls back the local transaction and enlists in the existing distributed transaction as requested. Sie werden nicht bemerken, dass für die lokale Transaktion ein Rollback ausgeführt wurde und Sie für die Verwaltung aller lokalen Transaktionen verantwortlich sind, die nicht mit BeginTransactiongestartet wurden.You won't receive notice that the local transaction was rolled back and are responsible for managing any local transactions not started using BeginTransaction.

Gilt für:

Siehe auch