DbDataReader.IsDBNullAsync Метод

Определение

Пространство имен:

System.Data.Common

Сборки:

netstandard.dll, System.Data.Common.dll

Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения.

Перегрузки

Имя	Описание
IsDBNullAsync(Int32)	Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения.
IsDBNullAsync(Int32, CancellationToken)	Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения.

IsDBNullAsync(Int32)

Исходный код:

DbDataReader.cs

Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения.

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)

Параметры

ordinal

Int32

Извлекаемый от нуля столбец.

Возвращаемое значение

Task<Boolean>

Свойство Task<TResult> , свойство которого Result равно true указанному значению DBNull столбца или false если это не так.

Исключения

InvalidOperationException

Подключение было удалено или закрыто во время извлечения данных.

–или–

Средство чтения данных закрывается во время извлечения данных.

–или–

Нет данных, готовых к чтению (например, первый Read() не был вызван или возвращен false).

–или–

Попытка считывания ранее прочитанного столбца в последовательном режиме.

–или–

Выполняется асинхронная операция. Это относится ко всем методам Get* при выполнении в последовательном режиме, так как они могут вызываться при чтении потока.

IndexOutOfRangeException

Индекс столбца выходит за пределы диапазона.

Комментарии

Этот асинхронный метод необходим только для предотвращения блокировки вызывающего потока при создании средства чтения в последовательном режиме.

Если последовательный режим не указан, все значения столбцов должны быть доступны в памяти при каждом завершении ReadAsync, и вызов синхронной версии метода не должен блокировать вызывающий поток.

Реализация этого асинхронного метода по умолчанию вызывает его синхронный аналог и возвращает завершенную задачу, потенциально блокируя вызывающий поток.

Поставщики данных, поддерживающие асинхронное программирование, должны переопределить реализацию по умолчанию с помощью асинхронных операций ввода-вывода.

Другие методы и свойства объекта DbDataReader не должны вызываться, пока возвращенная задача еще не завершена.

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых IsDBNull(Int32).

IsDBNullAsync(Int32, CancellationToken)

Исходный код:

DbDataReader.cs

Асинхронно получает значение, указывающее, содержит ли столбец отсутствующие или отсутствующие значения.

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>

Public Overridable Function IsDBNullAsync (ordinal As Integer, cancellationToken As CancellationToken) As Task(Of Boolean)

Параметры

ordinal

Int32

Извлекаемый от нуля столбец.

cancellationToken

CancellationToken

Маркер для отмены асинхронной операции.

Возвращаемое значение

Task<Boolean>

Свойство Task<TResult> , свойство которого Result равно true указанному значению DBNull столбца или false если это не так.

Исключения

InvalidOperationException

Подключение было удалено или закрыто во время извлечения данных.

–или–

Средство чтения данных закрывается во время извлечения данных.

–или–

Нет данных, готовых к чтению (например, первый Read() не был вызван или возвращен false).

–или–

Попытка считывания ранее прочитанного столбца в последовательном режиме.

–или–

Выполняется асинхронная операция. Это относится ко всем методам Get* при выполнении в последовательном режиме, так как они могут вызываться при чтении потока.

IndexOutOfRangeException

Индекс столбца выходит за пределы диапазона.

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

Этот асинхронный метод необходим только для предотвращения блокировки вызывающего потока при создании средства чтения в последовательном режиме.

Если последовательный режим не указан, все значения столбцов должны быть доступны в памяти при каждом завершении ReadAsync, и вызов синхронной версии метода не должен блокировать вызывающий поток.

Реализация этого асинхронного метода по умолчанию вызывает его синхронный аналог и возвращает завершенную задачу, потенциально блокируя вызывающий поток. Реализация по умолчанию также возвращает отмененную задачу при передаче уже отмененного маркера отмены.

Поставщики данных, поддерживающие асинхронное программирование, должны переопределить реализацию по умолчанию с помощью асинхронных операций ввода-вывода.

Этот метод принимает маркер отмены, который можно использовать для запроса на отмену операции раньше. Реализации могут игнорировать этот запрос.

Другие методы и свойства объекта DbDataReader не должны вызываться, пока возвращенная задача еще не завершена. Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых IsDBNull(Int32).