DbDataReader.NextResultAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Setzt den Datenreader beim Lesen der Ergebnisse von Batchanweisungen asynchron auf das nächste Ergebnis.
Überlädt
NextResultAsync() |
Setzt den Datenreader beim Lesen der Ergebnisse von Batchanweisungen asynchron auf das nächste Ergebnis. |
NextResultAsync(CancellationToken) |
Setzt den Datenreader beim Lesen der Ergebnisse von Batchanweisungen asynchron auf das nächste Ergebnis. |
Hinweise
Weitere Informationen zur asynchronen Programmierung finden Sie unter Asynchrone Programmierung.
NextResultAsync()
- Quelle:
- DbDataReader.cs
- Quelle:
- DbDataReader.cs
- Quelle:
- DbDataReader.cs
Setzt den Datenreader beim Lesen der Ergebnisse von Batchanweisungen asynchron auf das nächste Ergebnis.
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)
Gibt zurück
Eine Aufgabe, deren Result-Eigenschaft true
ist, wenn weitere Resultsets vorhanden sind, andernfalls false
Ausnahmen
Ein Fehler, der beim Ausführen des Befehlstextes aufgetreten ist.
Hinweise
Die Standardimplementierung dieser asynchronen Methode ruft ihre synchrone Entsprechung auf und gibt einen abgeschlossenen Task zurück, der möglicherweise den aufrufenden Thread blockiert.
Datenanbieter, die asynchrone Programmierung unterstützen, sollten die Standardimplementierung mithilfe asynchroner E/A-Vorgänge außer Kraft setzen.
Andere Methoden und Eigenschaften des DbDataReader-Objekts sollten nicht aufgerufen werden, während die zurückgegebene Aufgabe noch nicht abgeschlossen ist. Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten NextResult()Ausnahmen.
Weitere Informationen
Gilt für:
NextResultAsync(CancellationToken)
- Quelle:
- DbDataReader.cs
- Quelle:
- DbDataReader.cs
- Quelle:
- DbDataReader.cs
Setzt den Datenreader beim Lesen der Ergebnisse von Batchanweisungen asynchron auf das nächste Ergebnis.
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)
Parameter
- cancellationToken
- CancellationToken
Die Abbruchanweisung.
Gibt zurück
Eine Task<TResult>, deren Result-Eigenschaft true
ist, wenn weitere Resultsets vorhanden sind, andernfalls false
.
Ausnahmen
Ein Fehler, der beim Ausführen des Befehlstextes aufgetreten ist.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Die Standardimplementierung dieser asynchronen Methode ruft ihre synchrone Entsprechung auf und gibt einen abgeschlossenen Task zurück, der möglicherweise den aufrufenden Thread blockiert. Die Standardimplementierung gibt auch einen abgebrochenen Task zurück, wenn ein bereits abgebrochenes Abbruchtoken übergeben wurde.
Datenanbieter, die asynchrone Programmierung unterstützen, sollten die Standardimplementierung mithilfe asynchroner E/A-Vorgänge außer Kraft setzen.
Diese Methode nimmt ein Abbruchtoken an, das verwendet werden kann, um ein frühes Abbrechen des Vorgangs anzufordern. Implementierungen können diese Anforderung ignorieren.
Andere Methoden und Eigenschaften des DbDataReader-Objekts sollten nicht aufgerufen werden, während die zurückgegebene Aufgabe noch nicht abgeschlossen ist. Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten NextResult()Ausnahmen.