DbBatch.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.Common

Zestaw:: System.Data.Common.dll

Źródło:: DbBatch.cs

Źródło:: DbBatch.cs

Źródło:: DbBatch.cs

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.

Dostawcy powinni zaimplementować tę metodę, aby zapewnić implementację nie domyślną dla ExecuteReader przeciążeń.

Domyślna implementacja wywołuje metodę synchroniczną ExecuteReader() i zwraca ukończone zadanie, blokując wątek wywołujący. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany token anulowania. Wyjątki zgłaszane przez element ExecuteReader będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania.

Ta metoda akceptuje token anulowania, który może służyć do żądania wcześniejszego anulowania operacji. Implementacje mogą ignorować to żądanie.

protected:
 abstract System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteDbDataReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);

protected abstract System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteDbDataReaderAsync (System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);

abstract member ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>

Protected MustOverride Function ExecuteDbDataReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of DbDataReader)

Parametry

behavior: CommandBehavior

Jedna z wartości wyliczenia, która określa opcje wykonywania wsadowego i pobierania danych.

cancellationToken: CancellationToken

Token umożliwiający anulowanie operacji asynchronicznej.

Zwraca

Task<DbDataReader>

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego, zobacz Programowanie asynchroniczne.

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez ExecuteDbDataReader(CommandBehavior)usługę .

Dotyczy