DbDataReader.ReadAsync Metoda

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Asynchronicznie zwiększa czytnik do następnego rekordu w zestawie wyników.

Przeciążenia

ReadAsync()	Asynchronicznie zwiększa czytnik do następnego rekordu w zestawie wyników.
ReadAsync(CancellationToken)	Asynchronicznie zwiększa czytnik do następnego rekordu w zestawie wyników.

Uwagi

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

ReadAsync()

Źródło:

DbDataReader.cs

Asynchronicznie zwiększa czytnik do następnego rekordu w zestawie wyników.

public:
 System::Threading::Tasks::Task<bool> ^ ReadAsync();

public System.Threading.Tasks.Task<bool> ReadAsync ();

member this.ReadAsync : unit -> System.Threading.Tasks.Task<bool>

Public Function ReadAsync () As Task(Of Boolean)

Zwraca

Task<Boolean>

Obiekt Task<TResult> , którego Result właściwość ma true wartość , jeśli istnieje więcej wierszy lub false jeśli nie ma.

Wyjątki

DbException

Wystąpił błąd podczas wykonywania tekstu polecenia.

Uwagi

Domyślna implementacja tej metody asynchronicznej wywołuje synchroniczny odpowiednik i zwraca ukończone zadanie, co potencjalnie blokuje wywołujący wątek.

Dostawcy danych, którzy obsługują programowanie asynchroniczne , powinni zastąpić domyślną implementację przy użyciu asynchronicznych operacji we/wy.

Inne metody i właściwości obiektu DbDataReader nie powinny być wywoływane, gdy zwrócone zadanie nie zostało jeszcze ukończone.

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

Zobacz też

• Omówienie ADO.NET

ReadAsync(CancellationToken)

Źródło:

DbDataReader.cs

Asynchronicznie zwiększa czytnik do następnego rekordu w zestawie wyników.

public:
 virtual System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<bool> ReadAsync (System.Threading.CancellationToken cancellationToken);

abstract member ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Parametry

cancellationToken

CancellationToken

Instrukcja anulowania.

Zwraca

Task<Boolean>

Obiekt Task<TResult> , którego Result właściwość ma true wartość , jeśli istnieje więcej wierszy lub false jeśli nie ma.

Wyjątki

DbException

Wystąpił błąd podczas wykonywania tekstu polecenia.

OperationCanceledException

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

Uwagi

Domyślna implementacja tej metody asynchronicznej wywołuje synchroniczny odpowiednik i zwraca ukończone zadanie, co potencjalnie blokuje wywołujący wątek. Domyślna implementacja zwraca również anulowane zadanie, jeśli przekazano już anulowany token anulowania.

Dostawcy danych, którzy obsługują programowanie asynchroniczne , powinni zastąpić domyślną implementację przy użyciu asynchronicznych operacji we/wy.

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

Inne metody i właściwości obiektu DbDataReader nie powinny być wywoływane, gdy zwrócone zadanie nie zostało jeszcze ukończone.

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

Zobacz też

• Omówienie ADO.NET