DbDataReader.IsDBNullAsync DbDataReader.IsDBNullAsync DbDataReader.IsDBNullAsync DbDataReader.IsDBNullAsync Method

Definition

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

Überlädt

IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken)

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32)

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken)

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

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>

Parameter

ordinal
Int32 Int32 Int32 Int32

Die nullbasierte abzurufende Spalte.The zero-based column to be retrieved.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Ein Token zum Abbrechen des asynchronen Vorgangs.A token to cancel the asynchronous operation.

Gibt zurück

Eine Task<TResult>, deren Result-Eigenschaft true ist, wenn der angegebene Spaltenwert DBNull entspricht, andernfalls false.A Task<TResult> whose Result property is true if the specified column value is equivalent to DBNull or false if it is not.

Ausnahmen

Die Verbindung wurde während des Datenabrufs gelöscht oder geschlossen.The connection was dropped or closed during the data retrieval.

- oder --or-

Der Datenreader wurde während des Datenabrufs geschlossen.The data reader is closed during the data retrieval.

- oder --or-

Es gibt keine Daten, die gelesen werden können (der erste Aufruf von Read() hat z. B. nicht stattgefunden oder "false" zurückgegeben).There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

- oder --or-

Es wird versucht, eine zuvor gelesene Spalte im sequenziellen Modus zu lesen.Trying to read a previously read column in sequential mode.

- oder --or- Es gab einen aktiven asynchronen Vorgang.There was an asynchronous operation in progress. 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.This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

Der Spaltenindex ist außerhalb des gültigen Bereichs.The column index is out of range.

Hinweise

Diese asynchrone Methode wird nur benötigt, um zu verhindern, dass der aufrufende Thread blockiert wird, wenn der Reader im sequenziellen Modus erstellt wird.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Wenn der sequenzielle Modus nicht angegeben wird, sollten alle Spaltenwerte im Arbeitsspeicher verfügbar werden, sobald "leseasync" abgeschlossen ist, und der Aufruf der synchronen Version der Methode sollte den aufrufenden Thread nicht blockieren.If sequential mode isn't specified, all column values should become available in memory each time ReadAsync completes, and calling the synchronous version of the method shouldn't block the calling thread.

Die Standard Implementierung dieser asynchronen Methode ruft die synchrone Entsprechung auf und gibt eine abgeschlossene Aufgabe zurück, die möglicherweise den aufrufenden Thread blockiert.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread. Die Standard Implementierung gibt auch eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruch Token übergangen wird.The default implementation also returns a cancelled task if passed an already cancelled cancellation token.

Datenanbieter, die die asynchrone Programmierung unterstützen, sollten die standardmäßige inmplementierung mithilfe von asynchronen e/a-Vorgängen überschreiben.Data providers that support asynchronous programming should override the default inmplementation using asynchronous I/O operations.

Diese Methode nimmt ein Abbruchtoken an, das verwendet werden kann, um ein frühes Abbrechen des Vorgangs anzufordern.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Implementierungen können diese Anforderung ignorieren.Implementations may ignore this request.

Andere Methoden und Eigenschaften des DbDataReader-Objekts sollten nicht aufgerufen werden, während die zurückgegebene Aufgabe noch nicht abgeschlossen ist.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32)

Ruft asynchron einen Wert ab, der angibt, ob die Spalte nicht vorhandene oder fehlende Werte enthält.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

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 Int32 Int32 Int32

Die nullbasierte abzurufende Spalte.The zero-based column to be retrieved.

Gibt zurück

Eine Task<TResult>, deren Result-Eigenschaft true ist, wenn der angegebene Spaltenwert DBNull entspricht, andernfalls false.A Task<TResult> whose Result property is true if the specified column value is equivalent to DBNull or false if it is not.

Ausnahmen

Die Verbindung wurde während des Datenabrufs gelöscht oder geschlossen.The connection was dropped or closed during the data retrieval.

- oder --or-

Der Datenreader wurde während des Datenabrufs geschlossen.The data reader is closed during the data retrieval.

- oder --or-

Es gibt keine Daten, die gelesen werden können (der erste Aufruf von Read() hat z. B. nicht stattgefunden oder "false" zurückgegeben).There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

- oder --or-

Es wird versucht, eine zuvor gelesene Spalte im sequenziellen Modus zu lesen.Trying to read a previously read column in sequential mode.

- oder --or-

Es gab einen aktiven asynchronen Vorgang.There was an asynchronous operation in progress. 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.This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

Der Spaltenindex ist außerhalb des gültigen Bereichs.The column index is out of range.

Hinweise

Diese asynchrone Methode wird nur benötigt, um zu verhindern, dass der aufrufende Thread blockiert wird, wenn der Reader im sequenziellen Modus erstellt wird.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Wenn der sequenzielle Modus nicht angegeben wird, sollten alle Spaltenwerte im Arbeitsspeicher verfügbar werden, sobald "leseasync" abgeschlossen ist, und der Aufruf der synchronen Version der Methode sollte den aufrufenden Thread nicht blockieren.If sequential mode isn't specified, all column values should become available in memory each time ReadAsync completes, and calling the synchronous version of the method shouldn't block the calling thread.

Die Standard Implementierung dieser asynchronen Methode ruft die synchrone Entsprechung auf und gibt eine abgeschlossene Aufgabe zurück, die möglicherweise den aufrufenden Thread blockiert.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread.

Datenanbieter, die die asynchrone Programmierung unterstützen, sollten die standardmäßige inmplementierung mithilfe von asynchronen e/a-Vorgängen überschreiben.Data providers that support asynchronous programming should override the default inmplementation using asynchronous I/O operations.

Andere Methoden und Eigenschaften des DbDataReader-Objekts sollten nicht aufgerufen werden, während die zurückgegebene Aufgabe noch nicht abgeschlossen ist.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

Gilt für: