DbCommand.PrepareAsync(CancellationToken) Metoda

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Źródło:

DbCommand.cs

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.Task

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

Parametry

cancellationToken

CancellationToken

Opcjonalny token umożliwiający anulowanie operacji asynchronicznej. Wartość domyślna to None.

Zwraca

Task

Reprezentująca Task operację asynchroniczną.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Domyślna implementacja tej asynchronicznej metody deleguje do jego synchronicznego odpowiednika i zwraca ukończony Task, potencjalnie blokujący 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 wartość StoredProcedure, wywołanie PrepareAsync powinno zakończyć się powodzeniem, chociaż może to spowodować brak operacji.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. 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 Prepare()usługę .