SqlDataReader.ReadAsync(CancellationToken) Метод

Определение

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

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Асинхронная версия 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

Инструкция отмены.

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

Task<Boolean>

Задача, представляющая асинхронную операцию.

Исключения

InvalidOperationException

Вызов ReadAsync(CancellationToken) более одного раза для того же экземпляра до завершения задачи.

SqlException

SQL Server вернул ошибку во время выполнения текста команды.

Комментарии

behavior Если параметр имеет ExecuteReaderAsync значение Default, ReadAsync считывает всю строку перед возвратом задачи.

Дополнительные сведения об асинхронном программировании в поставщике данных платформа .NET Framework для SQL Server см. в статье Асинхронное программирование.

Примечание

При чтении больших данных (двоичных или текстовых) рекомендуется использовать Read для оптимальной производительности.