SqlDataReader.IsDBNullAsync(Int32, CancellationToken) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронная версия IsDBNull(Int32), которая получает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения.
Маркер отмены можно использовать для запроса на то, что операция будет прекращена до истечения времени ожидания команды. Исключения будут сообщаться с помощью возвращаемого объекта 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)Параметры
- i
- Int32
Извлекаемый от нуля столбец.
- cancellationToken
- CancellationToken
Инструкция отмены, которая распространяет уведомление об отмене операций. Это не гарантирует отмену. Параметр CancellationToken.None делает этот метод эквивалентным IsDBNull(Int32). Возвращаемая задача должна быть помечена как отмененная.
Возвращаемое значение
true Значение столбца, равное значению DBNullfalseуказанного столбца.
Исключения
Подключение удаляется или закрывается во время извлечения данных.
Он SqlDataReader закрывается во время извлечения данных.
Нет данных, готовых к чтению (например, первый Read() не был вызван или возвращен false).
Попытка считывания ранее прочитанного столбца в последовательном режиме.
Выполняется асинхронная операция. Это относится ко всем методам Get* при выполнении в последовательном режиме, так как они могут вызываться при чтении потока.
Context Connection=true указывается в строка подключения.
Попытка считывать столбец, который не существует.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
Дополнительные сведения см. в разделе "Поддержка потоковой передачи SqlClient".
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых IsDBNull(Int32).
