DbDataReader.IsDBNullAsync 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.
Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.
Überlädt
| Name | Beschreibung |
|---|---|
| IsDBNullAsync(Int32) |
Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält. |
| IsDBNullAsync(Int32, CancellationToken) |
Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält. |
IsDBNullAsync(Int32)
Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.
public:
System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int ordinal);public System.Threading.Tasks.Task<bool> IsDBNullAsync(int ordinal);member this.IsDBNullAsync : int -> System.Threading.Tasks.Task<bool>Public Function IsDBNullAsync (ordinal As Integer) As Task(Of Boolean)Parameter
- ordinal
- Int32
Die nullbasierte Spalte, die abgerufen werden soll.
Gibt zurück
Eine Task<TResult> Eigenschaft, deren Result Eigenschaft ist true , wenn der angegebene Spaltenwert gleichbedeutend DBNull ist oder false nicht.
Ausnahmen
Die Verbindung wurde während des Datenabrufs verworfen oder geschlossen.
-oder-
Der Datenleser wird während des Datenabrufs geschlossen.
-oder-
Es sind keine Daten zum Lesen bereit (z. B. wurde der erste Read() nicht aufgerufen oder "false" zurückgegeben).
-oder-
Versuchen Sie, eine zuvor gelesene Spalte im sequenziellen Modus zu lesen.
-oder-
Es wurde ein asynchroner Vorgang ausgeführt. Dies gilt für alle Get*-Methoden, wenn sie im sequenziellen Modus ausgeführt werden, da sie beim Lesen eines Datenstroms aufgerufen werden können.
Der Spaltenindex liegt außerhalb des Bereichs.
Hinweise
Diese asynchrone Methode ist nur erforderlich, um das Blockieren des aufrufenden Threads zu vermeiden, wenn der Reader im sequenziellen Modus erstellt wird.
Wenn der sequenzielle Modus nicht angegeben ist, sollten alle Spaltenwerte bei jedem Abschluss von ReadAsync im Arbeitsspeicher verfügbar werden, und das Aufrufen der synchronen Version der Methode sollte den aufrufenden Thread nicht blockieren.
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 IsDBNull(Int32).
Gilt für:
IsDBNullAsync(Int32, CancellationToken)
Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.
public:
virtual System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int ordinal, System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<bool> IsDBNullAsync(int ordinal, System.Threading.CancellationToken cancellationToken);abstract member IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function IsDBNullAsync (ordinal As Integer, cancellationToken As CancellationToken) As Task(Of Boolean)Parameter
- ordinal
- Int32
Die nullbasierte Spalte, die abgerufen werden soll.
- cancellationToken
- CancellationToken
Ein Token zum Abbrechen des asynchronen Vorgangs.
Gibt zurück
Eine Task<TResult> Eigenschaft, deren Result Eigenschaft ist true , wenn der angegebene Spaltenwert gleichbedeutend DBNull ist oder false nicht.
Ausnahmen
Die Verbindung wurde während des Datenabrufs verworfen oder geschlossen.
-oder-
Der Datenleser wird während des Datenabrufs geschlossen.
-oder-
Es sind keine Daten zum Lesen bereit (z. B. wurde der erste Read() nicht aufgerufen oder "false" zurückgegeben).
-oder-
Versuchen Sie, eine zuvor gelesene Spalte im sequenziellen Modus zu lesen.
-oder-
Es wurde ein asynchroner Vorgang ausgeführt. Dies gilt für alle Get*-Methoden, wenn sie im sequenziellen Modus ausgeführt werden, da sie beim Lesen eines Datenstroms aufgerufen werden können.
Der Spaltenindex liegt außerhalb des Bereichs.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Diese asynchrone Methode ist nur erforderlich, um das Blockieren des aufrufenden Threads zu vermeiden, wenn der Reader im sequenziellen Modus erstellt wird.
Wenn der sequenzielle Modus nicht angegeben ist, sollten alle Spaltenwerte bei jedem Abschluss von ReadAsync im Arbeitsspeicher verfügbar werden, und das Aufrufen der synchronen Version der Methode sollte den aufrufenden Thread nicht blockieren.
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 IsDBNull(Int32).