DbDataReader.IsDBNullAsync DbDataReader.IsDBNullAsync DbDataReader.IsDBNullAsync DbDataReader.IsDBNullAsync Method

Определение

Асинхронно получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

Перегрузки

IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken)

Асинхронно получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32)

Асинхронно получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения.Asynchronously gets a value that indicates whether the column contains non-existent or missing values.

IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken) IsDBNullAsync(Int32, CancellationToken)

Асинхронно получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения.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>

Параметры

ordinal
Int32 Int32 Int32 Int32

Извлекаемый столбец (отсчитываемый с нуля).The zero-based column to be retrieved.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Токен для отмены асинхронной операции.A token to cancel the asynchronous operation.

Возвраты

Объект Task<TResult>, свойство Result которого равно true, если указанное значение столбца эквивалентно значению DBNull, или false в противном случае.A Task<TResult> whose Result property is true if the specified column value is equivalent to DBNull or false if it is not.

Исключения

Соединение было удалено или закрыто во время получения данных.The connection was dropped or closed during the data retrieval.

- или --or-

Модуль чтения данных закрыт во время получения данных.The data reader is closed during the data retrieval.

-или--or-

Не существует данных, готовых для чтения (например, первый объект Read() не был вызван или вернул значение false).There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

- или --or-

Попытка чтения ранее считанного столбца в последовательном режиме.Trying to read a previously read column in sequential mode.

- или --or- Выполнялась асинхронная операция.There was an asynchronous operation in progress. Относится ко всем методам Get* при работе в последовательном режиме, так как они могут вызываться при чтении потока.This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

Индекс столбца находится за пределами диапазона.The column index is out of range.

Комментарии

Этот асинхронный метод необходим, чтобы не блокировать вызывающий поток при создании модуля чтения в последовательном режиме.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Если последовательный режим не указан, все значения столбцов должны быть доступны в памяти каждый раз, когда ReadAsync завершается, а вызов синхронной версии метода не должен блокировать вызывающий поток.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.

Реализация этого асинхронного метода по умолчанию вызывает его синхронный аналог и возвращает завершенную задачу, потенциально блокируя вызывающий поток.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread. Реализация по умолчанию также возвращает отмененную задачу, если она передала уже отмененный токен отмены.The default implementation also returns a cancelled task if passed an already cancelled cancellation token.

Поставщики данных, поддерживающие Асинхронное программирование , должны переопределять реализацию по умолчанию с помощью асинхронных операций ввода-вывода.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Этот метод принимает токен отмены, который может использоваться для запроса ранней отмены операции.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Реализации могут игнорировать данный запрос.Implementations may ignore this request.

Другие методы и свойства объекта DbDataReader не должны вызываться, когда возвращаемая задача еще не завершена.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32) IsDBNullAsync(Int32)

Асинхронно получает значение, указывающее, содержит ли столбец несуществующие или пропущенные значения.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)

Параметры

ordinal
Int32 Int32 Int32 Int32

Извлекаемый столбец (отсчитываемый с нуля).The zero-based column to be retrieved.

Возвраты

Объект Task<TResult>, свойство Result которого равно true, если указанное значение столбца эквивалентно значению DBNull, или false в противном случае.A Task<TResult> whose Result property is true if the specified column value is equivalent to DBNull or false if it is not.

Исключения

Соединение было удалено или закрыто во время получения данных.The connection was dropped or closed during the data retrieval.

- или --or-

Модуль чтения данных закрыт во время получения данных.The data reader is closed during the data retrieval.

- или --or-

Не существует данных, готовых для чтения (например, первый объект Read() не был вызван или вернул значение false).There is no data ready to be read (for example, the first Read() hasn't been called, or returned false).

- или --or-

Попытка чтения ранее считанного столбца в последовательном режиме.Trying to read a previously read column in sequential mode.

- или --or-

Выполнялась асинхронная операция.There was an asynchronous operation in progress. Относится ко всем методам Get* при работе в последовательном режиме, так как они могут вызываться при чтении потока.This applies to all Get* methods when running in sequential mode, as they could be called while reading a stream.

Индекс столбца находится за пределами диапазона.The column index is out of range.

Комментарии

Этот асинхронный метод необходим, чтобы не блокировать вызывающий поток при создании модуля чтения в последовательном режиме.This asynchronous method is only needed to avoid blocking the calling thread when the reader is created in sequential mode.

Если последовательный режим не указан, все значения столбцов должны быть доступны в памяти каждый раз, когда ReadAsync завершается, а вызов синхронной версии метода не должен блокировать вызывающий поток.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.

Реализация этого асинхронного метода по умолчанию вызывает его синхронный аналог и возвращает завершенную задачу, потенциально блокируя вызывающий поток.The default implementation of this asynchronous method invokes its synchronous counterpart and returns a completed Task, potentially blocking the calling thread.

Поставщики данных, поддерживающие Асинхронное программирование , должны переопределять реализацию по умолчанию с помощью асинхронных операций ввода-вывода.Data providers that support asynchronous programming should override the default implementation using asynchronous I/O operations.

Другие методы и свойства объекта DbDataReader не должны вызываться, когда возвращаемая задача еще не завершена.Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed.

Применяется к