SqlDataReader.IsDBNullAsync(Int32, CancellationToken) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

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 Zadania.

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

Kolumna oparta na zerach, która ma zostać pobrana.

cancellationToken

CancellationToken

Instrukcja anulowania, która propaguje powiadomienie o anulowaniu operacji. Nie gwarantuje to anulowania. Ustawienie powoduje CancellationToken.None , że ta metoda jest równoważna IsDBNull(Int32). Zwrócone zadanie musi być 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 spada lub jest zamykane podczas pobierania danych.

Element SqlDataReader jest zamknięty podczas pobierania danych.

Nie ma danych gotowych do odczytu (na przykład pierwszy Read() nie został wywołany lub zwrócony fałsz).

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.

IndexOutOfRangeException

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

Uwagi

Aby uzyskać więcej informacji, zobacz Obsługa przesyłania strumieniowego sqlClient.