DbDataReader.NextResultAsync Метод

Определение

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

System.Data.Common

Сборки:

netstandard.dll, 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