DbDataReader.ReadAsync 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.
Wechselt den Leser asynchron zum nächsten Datensatz in einem Resultset.
Überlädt
| Name | Beschreibung |
|---|---|
| ReadAsync() |
Wechselt den Leser asynchron zum nächsten Datensatz in einem Resultset. |
| ReadAsync(CancellationToken) |
Wechselt den Leser asynchron zum nächsten Datensatz in einem Resultset. |
Hinweise
Weitere Informationen zur asynchronen Programmierung finden Sie unter "Asynchrone Programmierung".
ReadAsync()
Wechselt den Leser asynchron zum nächsten Datensatz in einem Resultset.
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)Gibt zurück
Eine Task<TResult> Eigenschaft, deren Result Eigenschaft ist true , wenn mehr Zeilen vorhanden sind oder false nicht.
Ausnahmen
Fehler beim Ausführen des Befehlstexts.
Hinweise
Die Standardimplementierung dieser asynchronen Methode ruft das synchrone Gegenstück auf und gibt eine abgeschlossene Aufgabe zurück, die den aufrufenden Thread potenziell blockiert.
Datenanbieter, die die asynchrone Programmierung unterstützen, sollten die Standardimplementierung mit asynchronen E/A-Vorgängen überschreiben.
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 alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Read().
Weitere Informationen
Gilt für:
ReadAsync(CancellationToken)
Wechselt den Leser asynchron zum nächsten Datensatz in einem Resultset.
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)Parameter
- cancellationToken
- CancellationToken
Die Abbruchanweisung.
Gibt zurück
Eine Task<TResult> Eigenschaft, deren Result Eigenschaft ist true , wenn mehr Zeilen vorhanden sind oder false nicht.
Ausnahmen
Fehler beim Ausführen des Befehlstexts.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Die Standardimplementierung dieser asynchronen Methode ruft das synchrone Gegenstück auf und gibt eine abgeschlossene Aufgabe zurück, die den aufrufenden Thread potenziell blockiert. Die Standardimplementierung gibt auch eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruchtoken übergeben wurde.
Datenanbieter, die die asynchrone Programmierung unterstützen, sollten die Standardimplementierung mit asynchronen E/A-Vorgängen überschreiben.
Diese Methode akzeptiert ein Abbruchtoken, mit dem der Vorgang frühzeitig abgebrochen werden kann. 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 alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Read().