DbDataReader.ReadAsync Метод

Определение

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

System.Data.Common

Сборка:

System.Data.Common.dll

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

Перегрузки

ReadAsync()	Асинхронно перемещает модуль чтения к следующей записи в результирующем наборе.
ReadAsync(CancellationToken)	Асинхронно перемещает модуль чтения к следующей записи в результирующем наборе.

Комментарии

Дополнительные сведения об асинхронном программировании см. в разделе Асинхронное программирование.

ReadAsync()

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

DbDataReader.cs

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

public:
 System::Threading::Tasks::Task<bool> ^ ReadAsync();

public System.Threading.Tasks.Task<bool> ReadAsync ();

member this.ReadAsync : unit -> System.Threading.Tasks.Task<bool>

Public Function ReadAsync () As Task(Of Boolean)

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

Task<Boolean>

Объект Task<TResult>, свойство Result которого имеет значение true, если есть еще строки, или false в противном случае.

Исключения

DbException

Ошибка, произошедшая при попытке выполнения текста команды.

Комментарии

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

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

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

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

См. также раздел

• Общие сведения об ADO.NET

ReadAsync(CancellationToken)

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

DbDataReader.cs

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

public:
 virtual System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<bool> ReadAsync (System.Threading.CancellationToken cancellationToken);

abstract member ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Параметры

cancellationToken

CancellationToken

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

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

Task<Boolean>

Объект Task<TResult>, свойство Result которого имеет значение true, если есть еще строки, или false в противном случае.

Исключения

DbException

Ошибка, произошедшая при попытке выполнения текста команды.

OperationCanceledException

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

Комментарии

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

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

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

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

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

См. также раздел

• Общие сведения об ADO.NET