SqlConnection.EnlistDistributedTransaction(ITransaction) Methode

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Trägt sich in der angegebenen Transaktion als verteilte Transaktion ein.

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.

Hinweise

Sie können die EnlistTransaction -Methode verwenden, um sich in eine verteilte Transaktion ein eintragen zu lassen. Da EnlistTransaction eine Verbindung in einer Transaction Instanz eingibt, nutzt EnlistTransaction die System.Transactions im Namespace verfügbaren Funktionen zum Verwalten verteilter Transaktionen, sodass sie für diesen Zweck EnlistDistributedTransaction vorzuziehen ist. Weitere Informationen finden Sie unter Verteilte Transaktionen.

Sie können sich weiterhin in eine vorhandene verteilte Transaktion eintragen, indem Sie die EnlistDistributedTransaction-Methode verwenden, wenn die automatische Registrierung deaktiviert ist. Durch das Eintragen in eine vorhandene verteilte Transaktion wird sichergestellt, dass änderungen, die vom Code an der Datenquelle vorgenommen werden, auch committet oder rollback ausgeführt werden, wenn die Transaktion committet oder ein Rollback ausgeführt wird.

EnlistDistributedTransaction gibt eine Ausnahme zurück, wenn mit SqlConnection bereits eine Transaktion BeginTransactiongestartet wurde. Wenn es sich bei der Transaktion jedoch um eine lokale Transaktion handelt, die an der Datenquelle gestartet wurde (z. B. durch explizite Ausführung der BEGIN TRANSACTION-Anweisung mithilfe eines SqlCommand -Objekts), führt EnlistDistributedTransaction ein Rollback für die lokale Transaktion aus und führt die vorhandene verteilte Transaktion wie angefordert ein. Sie erhalten keine Benachrichtigung, dass für die lokale Transaktion ein Rollback ausgeführt wurde, und sind für die Verwaltung lokaler Transaktionen verantwortlich, die nicht mit BeginTransactiongestartet wurden.