Freigeben über


DbCommand.PrepareAsync(CancellationToken) Methode

Definition

Erstellt asynchron eine vorbereitete (oder kompilierte) Version des Befehls in der 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

A Task representing the asynchron operation.

Ausnahmen

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

Hinweise

Die Standardimplementierung dieser asynchronen Methode delegiert an das synchrone Gegenstück und gibt einen abgeschlossenen Task, möglicherweise blockierten Thread zurück.

Datenanbieter, die die asynchrone Programmierung unterstützen, sollten die Standardimplementierung mit asynchronen E/A-Vorgängen überschreiben.

Wenn die CommandType Eigenschaft auf TableDirect", PrepareAsync führt nichts aus. Wenn dieser auf <a0/> festgelegt ist, sollte der Aufruf erfolgreich ausgeführt werden, obwohl er zu einer no-opführen kann.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Prepare().

Gilt für: