Freigeben über


DbConnection.BeginTransactionAsync Methode

Definition

Überlädt

BeginTransactionAsync(CancellationToken)

Startet asynchron eine Datenbanktransaktion

BeginTransactionAsync(IsolationLevel, CancellationToken)

Startet asynchron eine Datenbanktransaktion

BeginTransactionAsync(CancellationToken)

Quelle:
DbConnection.cs
Quelle:
DbConnection.cs
Quelle:
DbConnection.cs

Startet asynchron eine Datenbanktransaktion

public System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction> BeginTransactionAsync (System.Threading.CancellationToken cancellationToken = default);
member this.BeginTransactionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction>
Public Function BeginTransactionAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbTransaction)

Parameter

cancellationToken
CancellationToken

Ein optionales Token zum Abbrechen des asynchronen Vorgangs. Der Standardwert ist None.

Gibt zurück

Eine Aufgabe, deren Result-Eigenschaft ein Objekt ist, das die neue Transaktion darstellt

Ausnahmen

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Wenn Sie keine Isolationsstufe angeben, wird die Standardisolationsstufe für den spezifischen Verbindungstyp verwendet.

Die Standardimplementierung dieser asynchronen Methode delegiert an ihre synchrone Entsprechung und gibt einen abgeschlossenen Taskzurück, der den aufrufenden Thread möglicherweise blockiert.

Datenanbieter, die asynchrone Programmierung unterstützen, sollten die Standardimplementierung mithilfe asynchroner E/A-Vorgänge außer Kraft setzen.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten BeginTransaction()Ausnahmen.

Gilt für:

BeginTransactionAsync(IsolationLevel, CancellationToken)

Quelle:
DbConnection.cs
Quelle:
DbConnection.cs
Quelle:
DbConnection.cs

Startet asynchron eine Datenbanktransaktion

public System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction> BeginTransactionAsync (System.Data.IsolationLevel isolationLevel, System.Threading.CancellationToken cancellationToken = default);
member this.BeginTransactionAsync : System.Data.IsolationLevel * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction>
Public Function BeginTransactionAsync (isolationLevel As IsolationLevel, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbTransaction)

Parameter

isolationLevel
IsolationLevel

Einer der Enumerationswerte, der die Isolationsstufe für die zu verwendende Transaktion angibt

cancellationToken
CancellationToken

Ein optionales Token zum Abbrechen des asynchronen Vorgangs. Der Standardwert ist None.

Gibt zurück

Eine Aufgabe, deren Result-Eigenschaft ein Objekt ist, das die neue Transaktion darstellt

Ausnahmen

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Die Standardimplementierung dieser asynchronen Methode delegiert an ihre synchrone Entsprechung und gibt einen abgeschlossenen Taskzurück, der den aufrufenden Thread möglicherweise blockiert.

Datenanbieter, die asynchrone Programmierung unterstützen, sollten die Standardimplementierung mithilfe asynchroner E/A-Vorgänge außer Kraft setzen.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten BeginTransaction(IsolationLevel)Ausnahmen.

Gilt für: