DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) 方法

定义

提供程序应执行该方法对 ExecuteReader 重载提供非默认的实现。

默认实现调用同步 ExecuteReader() 方法并返回已完成任务,以便阻止调用线程。 如果传递到已取消的取消标记,则默认实现将返回已取消的任务。 ExecuteReader 引发的异常将通过返回的任务异常属性传递。

该方法可用于请求操作之前接受取消标记。 实现可能会忽略该请求。

protected:
 virtual System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteDbDataReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);
protected virtual System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteDbDataReaderAsync (System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);
abstract member ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
override this.ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
Protected Overridable Function ExecuteDbDataReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of DbDataReader)

参数

behavior
CommandBehavior

CommandBehavior实例,指定命令执行和数据检索的选项。

cancellationToken
CancellationToken

用于取消异步操作的令牌。

返回

表示异步操作的任务。

例外

执行命令时出错。

取消令牌已取消。 此异常存储在返回的任务中。

注解

有关异步编程的详细信息,请参阅 异步编程

此方法将存储在任务中,它返回该方法的同步对应项可能引发的所有非使用异常。 如果异常存储在返回的任务中,则在等待任务时将引发该异常。 使用异常(如 ArgumentException)仍会同步引发。 有关存储的异常,请参阅 引发的 ExecuteDbDataReader(CommandBehavior)异常。

适用于

另请参阅