SqlDataReader.IsDBNullAsync(Int32, CancellationToken) Metoda

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.SqlClient.dll

Pakiet:

System.Data.SqlClient v4.8.6

Asynchroniczna wersja elementu IsDBNull(Int32), która pobiera wartość wskazującą, czy kolumna zawiera nieistniejące, czy brakujące wartości.

Token anulowania może służyć do żądania, aby operacja została porzucona przed upływem limitu czasu polecenia. Wyjątki będą zgłaszane za pośrednictwem zwróconego obiektu Task.

public:
 override System::Threading::Tasks::Task<bool> ^ IsDBNullAsync(int i, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<bool> IsDBNullAsync (int i, System.Threading.CancellationToken cancellationToken);

override this.IsDBNullAsync : int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overrides Function IsDBNullAsync (i As Integer, cancellationToken As CancellationToken) As Task(Of Boolean)

Parametry

i

Int32

Pobierana kolumna oparta na zerach.

cancellationToken

CancellationToken

Instrukcja anulowania, która propaguje powiadomienie, że operacje powinny zostać anulowane. Nie gwarantuje to anulowania. Ustawienie CancellationToken.None powoduje, że ta metoda jest równoważna IsDBNull(Int32). Zwrócone zadanie musi zostać oznaczone jako anulowane.

Zwraca

Task<Boolean>

true jeśli określona wartość kolumny jest równoważna DBNull w przeciwnym razie false.

Wyjątki

InvalidOperationException

Połączenie przerywa lub jest zamykane podczas pobierania danych.

Element SqlDataReader jest zamykany podczas pobierania danych.

Nie ma danych gotowych do odczytu (na przykład pierwsza Read() nie została wywołana lub zwrócona wartość false).

Próba odczytania wcześniej odczytanej kolumny w trybie sekwencyjnym.

W toku była operacja asynchroniczna. Dotyczy to wszystkich metod Get* podczas uruchamiania w trybie sekwencyjnym, ponieważ można je wywołać podczas odczytywania strumienia.

Context Connection=trueparametr jest określony w parametry połączenia.

IndexOutOfRangeException

Próba odczytania kolumny, która nie istnieje.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Aby uzyskać więcej informacji, zobacz SqlClient Streaming Support (Obsługa przesyłania strumieniowego sqlclient).

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez IsDBNull(Int32)usługę .