DbBatch.ExecuteReaderAsync Метод

Определение

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

System.Data.Common

Сборка:

System.Data.Common.dll

Перегрузки

ExecuteReaderAsync(CancellationToken)	Асинхронная версия ExecuteReader, которая выполняет пакет с подключением DbDataReader , возвращая объект , который можно использовать для доступа к результатам.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Асинхронная версия ExecuteReader, которая выполняет пакет с подключением DbDataReader , возвращая объект , который можно использовать для доступа к результатам.

ExecuteReaderAsync(CancellationToken)

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

DbBatch.cs

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

public System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteReaderAsync (System.Threading.CancellationToken cancellationToken = default);

member this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>

Public Function ExecuteReaderAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of DbDataReader)

Параметры

cancellationToken

CancellationToken

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

Task<DbDataReader>

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

Исключения

DbException

При выполнении пакета произошла ошибка.

ArgumentException

Значение CommandBehavior является недопустимым.

OperationCanceledException

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

Комментарии

Управляемые поставщики должны вызывать ExecuteDbDataReaderAsync в ExecuteReaderAsync. Дополнительные сведения об асинхронном программировании см. в разделе Асинхронное программирование.

ExecuteReaderAsync(CommandBehavior, CancellationToken)

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

DbBatch.cs

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

public System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteReaderAsync (System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken = default);

member this.ExecuteReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>

Public Function ExecuteReaderAsync (behavior As CommandBehavior, Optional cancellationToken As CancellationToken = Nothing) As Task(Of DbDataReader)

Параметры

behavior

CommandBehavior

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

cancellationToken

CancellationToken

Токен для отмены асинхронной операции.

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

Task<DbDataReader>

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

Исключения

DbException

При выполнении пакета произошла ошибка.

ArgumentException

Значение CommandBehavior является недопустимым.

OperationCanceledException

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

Комментарии

Управляемые поставщики должны вызывать ExecuteDbDataReaderAsync в ExecuteReaderAsync. Дополнительные сведения об асинхронном программировании см. в разделе Асинхронное программирование.

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