DbDataReader.ReadAsync Methode

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Setzt den Reader asynchron auf den nächsten Datensatz in einem Resultset.

Überlädt

ReadAsync()	Setzt den Reader asynchron auf den nächsten Datensatz in einem Resultset.
ReadAsync(CancellationToken)	Setzt den Reader asynchron auf den nächsten Datensatz in einem Resultset.

Hinweise

Weitere Informationen zur asynchronen Programmierung finden Sie unter Asynchrone Programmierung.

ReadAsync()

Source:

DbDataReader.cs

Setzt den Reader asynchron auf den 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

Task<Boolean>

Eine Task<TResult>, deren Result-Eigenschaft true ist, wenn weitere Zeilen vorhanden sind, andernfalls false.

Ausnahmen

DbException

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, wodurch der aufrufende Thread möglicherweise blockiert wird.

Datenanbieter, die die asynchrone Programmierung unterstützen, sollten die Standardimplementierung mit asynchronen E/A-Vorgängen 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 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. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Read().

Weitere Informationen

• Übersicht über ADO.NET

ReadAsync(CancellationToken)

Source:

DbDataReader.cs

Setzt den Reader asynchron auf den 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

Task<Boolean>

Eine Task<TResult>, deren Result-Eigenschaft true ist, wenn weitere Zeilen vorhanden sind, andernfalls false.

Ausnahmen

DbException

Ein Fehler, der beim Ausführen des Befehlstextes aufgetreten ist.

OperationCanceledException

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, wodurch der aufrufende Thread möglicherweise blockiert wird. Die Standardimplementierung gibt auch einen abgebrochenen Task 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 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 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. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Read().

Weitere Informationen

• Übersicht über ADO.NET