DbDataReader.ReadAsync Metoda

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

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

Przeciążenia

ReadAsync()	Asynchronicznie zwiększa czytelnika do następnego rekordu w zestawie wyników.
ReadAsync(CancellationToken)	Asynchronicznie zwiększa czytelnika 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 czytelnika 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>

Właściwość Task<TResult> , której Result właściwość jest, true 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, potencjalnie blokując 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.

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

Zobacz też

• Omówienie ADO.NET

ReadAsync(CancellationToken)

Źródło:

DbDataReader.cs

Asynchronicznie zwiększa czytelnika 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>

Właściwość Task<TResult> , której Result właściwość jest, true 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 zwróconym zadaniu.

Uwagi

Domyślna implementacja tej metody asynchronicznej wywołuje synchroniczny odpowiednik i zwraca ukończone zadanie, potencjalnie blokując wątek wywołujący. 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 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 Read()usługę .

Zobacz też

• Omówienie ADO.NET