SqlDataReader.IsDBNullAsync(Int32, CancellationToken) Метод

Определение

Асинхронная версия метода IsDBNull(Int32), который получает значение, указывающее, содержит ли столбец несуществующие или отсутствующие значения.An asynchronous version of IsDBNull(Int32), which gets a value that indicates whether the column contains non-existent or missing values.

Токен отмены можно использовать для запроса отказа от операции до истечения времени ожидания команды.The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Сведения об исключениях передаются в возвращенном объекте Task.Exceptions will be reported via the returned Task object.

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>

Параметры

i
Int32

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

cancellationToken
CancellationToken

Инструкция отмены, распространяющая уведомление о том, что операции должны быть отменены.The cancellation instruction, which propagates a notification that operations should be canceled. Не гарантирует отмену.This does not guarantee the cancellation. Параметр CancellationToken.None делает этот метод равным методу IsDBNull(Int32).A setting of CancellationToken.None makes this method equivalent to IsDBNull(Int32). Возвращаемая задача должна быть помечена как отмененная.The returned task must be marked as cancelled.

Возвраты

Значение true, если значение указанного столбца эквивалентно DBNull; в обратном случае — значение false.true if the specified column value is equivalent to DBNull otherwise false.

Исключения

Соединение разъединяется или закрывается во время извлечения данных.The connection drops or is closed during the data retrieval.

Объект SqlDataReader закрыт во время извлечения данных.The SqlDataReader is closed during the data retrieval.

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

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

Выполнялась асинхронная операция.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.

Context Connection=true задается в строке подключения.Context Connection=true is specified in the connection string.

Попытка чтения столбца, который не существует.Trying to read a column that does not exist.

Комментарии

Дополнительные сведения см. в разделе Поддержка потоковой передачи SqlClient.For more information, see SqlClient Streaming Support.

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