Sdílet prostřednictvím


DbCommand.PrepareAsync(CancellationToken) Metoda

Definice

Asynchronně vytvoří připravenou (nebo zkompilovanou) verzi příkazu ve zdroji dat.

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

Parametry

cancellationToken
CancellationToken

Volitelný token pro zrušení asynchronní operace. Výchozí hodnota je None.

Návraty

Představující Task asynchronní operaci.

Výjimky

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Výchozí implementace této asynchronní metody deleguje na svůj synchronní protějšek a vrátí dokončený Task, potenciálně blokuje volající vlákno.

Zprostředkovatelé dat, kteří podporují asynchronní programování , by měli přepsat výchozí implementaci pomocí asynchronních vstupně-výstupních operací.

Pokud je vlastnost nastavená CommandType na TableDirect, PrepareAsync neprovede nic. Pokud CommandType je nastavená hodnota StoredProcedure, mělo by volání operace proběhnout PrepareAsync úspěšně, i když to může mít za následek no-op.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Prepare().

Platí pro