DbDataReader.IsDBNullAsync Metoda

Definicja

Asynchronicznie Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące lub brakujące wartości.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

Przeciążenia

IsDBNullAsync(Int32, CancellationToken)

Asynchronicznie Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące lub brakujące wartości.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32)

Asynchronicznie Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące lub brakujące wartości.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32, CancellationToken)

Asynchronicznie Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące lub brakujące wartości.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>

Parametry

ordinal
Int32

Kolumna, która ma zostać pobrana (liczony od zera).The zero-based column to be retrieved.

cancellationToken
CancellationToken

Token anulowania operacji asynchronicznej.A token to cancel the asynchronous operation.

Zwraca

Task<TResult>, którego właściwość Result jest true, jeśli określona wartość kolumny jest równoważna z DBNull lub false, jeśli nie jest.A Task<TResult> whose Result property is true if the specified column value is equivalent to DBNull or false if it is not.

Wyjątki

Połączenie zostało porzucone lub zamknięte podczas pobierania danych.The connection was dropped or closed during the data retrieval.

lub-or-

Czytnik danych jest zamykany podczas pobierania danych.The data reader is closed during the data retrieval.

lub-or-

Brak danych gotowych do odczytu (na przykład, pierwsze Read() nie zostało wywołane lub zwróciło wartość false).There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

lub-or-

Próba odczytania poprzednio odczytanej kolumny w trybie sekwencyjnym.Trying to read a previously read column in sequential mode.

lub-or- Operacja asynchroniczna jest w toku.There was an asynchronous operation in progress. Dotyczy to wszystkich metod get * podczas uruchamiania w trybie sekwencyjnym, ponieważ mogą one być wywoływane podczas odczytywania strumienia.This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

Indeks kolumny jest poza zakresem.The column index is out of range.

Uwagi

Ta metoda asynchroniczna jest wymagana tylko w celu uniknięcia blokowania wątku wywołującego, gdy czytnik jest tworzony w trybie sekwencyjnym.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Jeśli tryb sekwencyjny nie jest określony, wszystkie wartości kolumn powinny być dostępne w pamięci za każdym razem, gdy ReadAsync kończy działanie, i wywołanie synchronicznej wersji metody nie powinno blokować wątku wywołującego.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.

Domyślna implementacja tej metody asynchronicznej wywołuje jej odpowiednik synchroniczny i zwraca ukończone zadanie, co może spowodować zablokowanie wątku wywołującego.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread. Domyślna implementacja zwraca również anulowane zadanie, jeśli zostało zakończone już anulowane tokeny anulowania.The default implementation also returns a cancelled task if passed an already cancelled cancellation token.

Dostawcy danych, którzy obsługują programowanie asynchroniczne , powinny zastąpić domyślną implementację przy użyciu asynchronicznych operacji we/wy.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Ta metoda akceptuje token anulowania, którego można użyć do żądania wcześniejszego anulowania operacji.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Implementacje mogą zignorować to żądanie.Implementations may ignore this request.

Inne metody i właściwości obiektu DbDataReader nie powinny być wywoływane, gdy zwrócone zadanie nie zostało jeszcze ukończone.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

IsDBNullAsync(Int32)

Asynchronicznie Pobiera wartość wskazującą, czy kolumna zawiera nieistniejące lub brakujące wartości.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)

Parametry

ordinal
Int32

Kolumna, która ma zostać pobrana (liczony od zera).The zero-based column to be retrieved.

Zwraca

Task<TResult>, którego właściwość Result jest true, jeśli określona wartość kolumny jest równoważna z DBNull lub false, jeśli nie jest.A Task<TResult> whose Result property is true if the specified column value is equivalent to DBNull or false if it is not.

Wyjątki

Połączenie zostało porzucone lub zamknięte podczas pobierania danych.The connection was dropped or closed during the data retrieval.

lub-or-

Czytnik danych jest zamykany podczas pobierania danych.The data reader is closed during the data retrieval.

lub-or-

Brak danych gotowych do odczytu (na przykład, pierwsze Read() nie zostało wywołane lub zwróciło wartość false).There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

lub-or-

Próba odczytania poprzednio odczytanej kolumny w trybie sekwencyjnym.Trying to read a previously read column in sequential mode.

lub-or-

Operacja asynchroniczna jest w toku.There was an asynchronous operation in progress. Dotyczy to wszystkich metod get * podczas uruchamiania w trybie sekwencyjnym, ponieważ mogą one być wywoływane podczas odczytywania strumienia.This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

Indeks kolumny jest poza zakresem.The column index is out of range.

Uwagi

Ta metoda asynchroniczna jest wymagana tylko w celu uniknięcia blokowania wątku wywołującego, gdy czytnik jest tworzony w trybie sekwencyjnym.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Jeśli tryb sekwencyjny nie jest określony, wszystkie wartości kolumn powinny być dostępne w pamięci za każdym razem, gdy ReadAsync kończy działanie, i wywołanie synchronicznej wersji metody nie powinno blokować wątku wywołującego.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.

Domyślna implementacja tej metody asynchronicznej wywołuje jej odpowiednik synchroniczny i zwraca ukończone zadanie, co może spowodować zablokowanie wątku wywołującego.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread.

Dostawcy danych, którzy obsługują programowanie asynchroniczne , powinny zastąpić domyślną implementację przy użyciu asynchronicznych operacji we/wy.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Inne metody i właściwości obiektu DbDataReader nie powinny być wywoływane, gdy zwrócone zadanie nie zostało jeszcze ukończone.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

Dotyczy