SqlDataReader.ReadAsync(CancellationToken) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Асинхронная версия Read(), которая переходит SqlDataReader к следующей записи.
Маркер отмены можно использовать для запроса на то, что операция будет прекращена до истечения времени ожидания команды. Исключения будут сообщаться с помощью возвращаемого объекта Task.
public:
override System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<bool> ReadAsync(System.Threading.CancellationToken cancellationToken);override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overrides Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)Параметры
- cancellationToken
- CancellationToken
Инструкция отмены.
Возвращаемое значение
Задача, представляющая асинхронную операцию.
Исключения
Вызов ReadAsync(CancellationToken) нескольких раз для одного экземпляра перед завершением задачи.
Context Connection=true указывается в строка подключения.
SQL Server возвращает ошибку при выполнении текста команды.
Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.
Комментарии
behavior Если для параметра ExecuteReaderAsync задано значение Default, ReadAsync считывает всю строку перед возвратом задачи.
Дополнительные сведения, включая примеры кода, об асинхронном программировании в .NET Framework Data Provider для SQL Server см. в разделе Asynchronous Programming.
Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему выбрасываются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых Read().
