DbCommand.PrepareAsync(CancellationToken) Metódus

Definíció

Névtér:

System.Data.Common

Szerelvények:

netstandard.dll, System.Data.Common.dll

Forrás:

DbCommand.cs

Aszinkron módon létrehozza a parancs előkészített (vagy lefordított) verzióját az adatforráson.

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

Paraméterek

cancellationToken

CancellationToken

Nem kötelező jogkivonat az aszinkron művelet megszakításához. Az alapértelmezett érték a None.

Válaszok

Task

Az Task aszinkron műveletet jelképező.

Kivételek

OperationCanceledException

A lemondási jogkivonat megszakadt. Ezt a kivételt a rendszer a visszaadott tevékenységben tárolja.

Megjegyzések

Ennek az aszinkron metódusnak az alapértelmezett implementációja a szinkron megfelelőjéhez delegál, és egy befejezett , potenciálisan a hívó szálat blokkoló befejezett Taskértéket ad vissza.

Az aszinkron programozást támogató adatszolgáltatóknak felül kell bírálnia az alapértelmezett implementációt aszinkron I/O-műveletek használatával.

Ha a CommandType tulajdonság be van állítva TableDirect, PrepareAsync nem tesz semmit. Ha CommandType be van állítva StoredProcedure, a hívásnak PrepareAsync sikeresnek kell lennie, bár ez no-operedményezhet.

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által Prepare()kiadott kivételeket: .