DbCommand.PrepareAsync(CancellationToken) Methode

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Quelle:

DbCommand.cs

Erstellt asynchron eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle.

public virtual System.Threading.Tasks.Task PrepareAsync (System.Threading.CancellationToken cancellationToken = default);

abstract member PrepareAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.PrepareAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function PrepareAsync (Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

cancellationToken

CancellationToken

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

Gibt zurück

Task

Eine Task, die den asynchronen Vorgang darstellt

Ausnahmen

OperationCanceledException

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 die asynchrone Programmierung unterstützen, sollten die Standardimplementierung mit asynchronen E/A-Vorgängen außer Kraft setzen.

Wenn die CommandType -Eigenschaft auf TableDirectfestgelegt ist, PrepareAsync wird nichts ausgeführt. Wenn CommandType auf StoredProcedurefestgelegt ist, sollte der Aufruf von PrepareAsync erfolgreich sein, obwohl dies zu einem No-Op führen kann.

Diese Methode speichert in der Aufgabe, die 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. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Prepare().