SqlDataReader.NextResultAsync(CancellationToken) Metoda

Definicja

Asynchroniczna wersja elementu NextResult(), która powoduje przejście czytnika danych do następnego wyniku podczas odczytywania wyników instrukcji transact-SQL wsadowych.

Token anulowania może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Zadania.

public:
 override System::Threading::Tasks::Task<bool> ^ NextResultAsync(System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<bool> NextResultAsync (System.Threading.CancellationToken cancellationToken);
override this.NextResultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overrides Function NextResultAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Parametry

cancellationToken
CancellationToken

Instrukcja anulowania.

Zwraca

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

Wywołanie NextResultAsync(CancellationToken) więcej niż raz dla tego samego wystąpienia przed ukończeniem zadania.

Context Connection=truejest określony w parametry połączenia.

SQL Server zwrócił błąd podczas wykonywania tekstu polecenia.

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

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

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 NextResult()usługę .

Dotyczy

Zobacz też