DbDataReader.NextResultAsync Метод

Определение

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

System.Data.Common

Сборка:

System.Data.Common.dll

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

Перегрузки

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

Комментарии

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

NextResultAsync()

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

DbDataReader.cs

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

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

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

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

Public Function NextResultAsync () As Task(Of Boolean)

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

Task<Boolean>

Задача, свойство Result которой имеет значение true, если результирующие наборы еще имеются, или false в противном случае.

Исключения

DbException

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

Комментарии

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

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

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

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

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

NextResultAsync(CancellationToken)

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

DbDataReader.cs

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

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

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

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

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

Параметры

cancellationToken

CancellationToken

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

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

Task<Boolean>

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

Исключения

DbException

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

OperationCanceledException

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

Комментарии

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

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

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

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

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

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