DbDataReader.NextResultAsync Metoda

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Asynchronicznie przechodzi czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji.

Przeciążenia

NextResultAsync()	Asynchronicznie przechodzi czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji.
NextResultAsync(CancellationToken)	Asynchronicznie przechodzi czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji.

Uwagi

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

NextResultAsync()

Źródło:

DbDataReader.cs

Asynchronicznie przechodzi czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji.

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

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

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

Public Function NextResultAsync () As Task(Of Boolean)

Zwraca

Task<Boolean>

Zadanie, którego Result właściwość ma wartość true , jeśli istnieje więcej zestawów wyników lub false jeśli nie istnieje.

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

Zobacz też

• Omówienie ADO.NET

NextResultAsync(CancellationToken)

Źródło:

DbDataReader.cs

Asynchronicznie przechodzi czytelnika do następnego wyniku podczas odczytywania wyników partii instrukcji.

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

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

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

Public Overridable Function NextResultAsync (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 zestawów wyników lub false jeśli nie istnieje.

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

Zobacz też

• Omówienie ADO.NET