DataReaderExtensions.IsDBNullAsync Methode

Definition

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.

public static System.Threading.Tasks.Task<bool> IsDBNullAsync (this System.Data.Common.DbDataReader reader, string name, System.Threading.CancellationToken cancellationToken = default);
static member IsDBNullAsync : System.Data.Common.DbDataReader * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
<Extension()>
Public Function IsDBNullAsync (reader As DbDataReader, name As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Boolean)

Parameter

reader
DbDataReader

Der Datenreader, bei dem der Spaltenwert abgerufen werden soll.

name
String

Der Name der Spalte.

cancellationToken
CancellationToken

Ein optionales Token zum Abbrechen des asynchronen Vorgangs.

Gibt zurück

Eine Task<TResult>, deren Result-Eigenschaft true ist, wenn der angegebene Spaltenwert DBNull entspricht, andernfalls false.

Ausnahmen

Die Verbindung wurde während des Datenabrufs gelöscht oder geschlossen.

- oder -

Der Datenreader wurde während des Datenabrufs geschlossen.

- oder -

Es gibt keine Daten, die gelesen werden können (der erste Aufruf von Read() hat z. B. nicht stattgefunden oder "false" zurückgegeben).

- oder -

Es wird versucht, eine zuvor gelesene Spalte im sequenziellen Modus zu lesen.

- oder -

Es gab einen aktiven asynchronen Vorgang. Dies gilt für alle Get*-Methoden bei der Ausführung im sequenziellen Modus, da sie aufgerufen werden können, während des Lesens eines Datenstroms.

Der angegebene Name ist kein gültiger Spaltenname.

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Diese asynchrone Methode ist nur erforderlich, um zu verhindern, dass der aufrufende Thread blockiert wird, wenn der Reader im sequenziellen Modus erstellt wird.

Wenn der sequenzielle Modus nicht angegeben ist, sollten bei jedem Abschluss von ReadAsync alle Spaltenwerte im Arbeitsspeicher verfügbar sein, und das Aufrufen der synchronen Version der Methode sollte den aufrufenden Thread nicht blockieren.

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 Standardinplementierung mithilfe asynchroner E/A-Vorgänge überschreiben.

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 IsDBNull(DbDataReader, String).

Gilt für: