Поделиться через


DbDataReader.ReadAsync Метод

Определение

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

Перегрузки

ReadAsync()

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

ReadAsync(CancellationToken)

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

Комментарии

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

ReadAsync()

Исходный код:
DbDataReader.cs
Исходный код:
DbDataReader.cs
Исходный код:
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<TResult>, свойство Result которого имеет значение true, если есть еще строки, или false в противном случае.

Исключения

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

Комментарии

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

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

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

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

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

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

ReadAsync(CancellationToken)

Исходный код:
DbDataReader.cs
Исходный код:
DbDataReader.cs
Исходный код:
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<TResult>, свойство Result которого имеет значение true, если есть еще строки, или false в противном случае.

Исключения

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

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

Комментарии

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

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

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

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

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

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

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