DbCommand.PrepareAsync(CancellationToken) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Asynchronicznie tworzy przygotowaną (lub skompilowana) wersję polecenia w źródle danych.
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.TaskPublic Overridable Function PrepareAsync (Optional cancellationToken As CancellationToken = Nothing) As TaskParametry
- cancellationToken
- CancellationToken
Opcjonalny token umożliwiający anulowanie operacji asynchronicznej. Domyślna wartość to None.
Zwraca
Reprezentująca Task operację asynchroniczną.
Wyjątki
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Domyślna implementacja tej asynchronicznej metody deleguje do synchronicznego odpowiednika i zwraca ukończony Taskelement , co potencjalnie blokuje wątek wywołujący.
Dostawcy danych, którzy obsługują programowanie asynchroniczne , powinni zastąpić domyślną implementację przy użyciu asynchronicznych operacji we/wy.
Jeśli właściwość jest ustawiona CommandType na TableDirectwartość , PrepareAsync nic nie robi. Jeśli CommandType ustawiono StoredProcedurewartość , wywołanie metody PrepareAsync powinno zakończyć się powodzeniem, chociaż może to spowodować no-op.
Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez program Prepare().
