DbCommand.ExecuteReaderAsync 方法

参考

定义

命名空间:: System.Data.Common

程序集:: System.Data.Common.dll

程序集:: System.Data.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

的 ExecuteReader异步版本，针对其连接执行命令，返回 DbDataReader 可用于访问结果的。

重载

ExecuteReaderAsync()	的 ExecuteReader异步版本，针对其连接执行命令，返回 DbDataReader 可用于访问结果的。通过 CancellationToken.None 调用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。
ExecuteReaderAsync(CommandBehavior)	的 ExecuteReader异步版本，针对其连接执行命令，返回 DbDataReader 可用于访问结果的。调用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteReaderAsync(CancellationToken)	的 ExecuteReader异步版本，针对其连接执行命令，返回 DbDataReader 可用于访问结果的。调用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteReaderAsync(CommandBehavior, CancellationToken)	调用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

注解

托管提供程序实现程序必须在中ExecuteReaderAsync调用 ExecuteDbDataReaderAsync 。有关异步编程的详细信息，请参阅异步编程。

ExecuteReaderAsync()

Source:: DbCommand.cs

Source:: DbCommand.cs

Source:: DbCommand.cs

的 ExecuteReader异步版本，针对其连接执行命令，返回 DbDataReader 可用于访问结果的。

通过 CancellationToken.None 调用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)。

public:
 System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteReaderAsync();

public System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteReaderAsync ();

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

Public Function ExecuteReaderAsync () As Task(Of DbDataReader)

Task<DbDataReader>

表示异步操作的任务。

例外

DbException

执行命令时出错。

ArgumentException

无效的 CommandBehavior 值。

注解

托管提供程序实现程序必须在中ExecuteReaderAsync调用 ExecuteDbDataReaderAsync 。有关异步编程的详细信息，请参阅异步编程。

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

另请参阅

ADO.NET 概述

适用于

ExecuteReaderAsync(CommandBehavior)

Source:: DbCommand.cs

Source:: DbCommand.cs

Source:: DbCommand.cs

的 ExecuteReader异步版本，针对其连接执行命令，返回 DbDataReader 可用于访问结果的。

调用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

public:
 System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior);

public System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteReaderAsync (System.Data.CommandBehavior behavior);

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

Public Function ExecuteReaderAsync (behavior As CommandBehavior) As Task(Of DbDataReader)

参数

behavior: CommandBehavior

枚举值之一，指定命令的执行方式和检索数据的方式。

Task<DbDataReader>

表示异步操作的任务。

例外

DbException

执行命令时出错。

ArgumentException

无效的 CommandBehavior 值。

注解

托管提供程序实现程序必须在中ExecuteReaderAsync调用 ExecuteDbDataReaderAsync 。有关异步编程的详细信息，请参阅异步编程。

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

另请参阅

ADO.NET 概述

适用于

ExecuteReaderAsync(CancellationToken)

Source:: DbCommand.cs

Source:: DbCommand.cs

Source:: DbCommand.cs

的 ExecuteReader异步版本，针对其连接执行命令，返回 DbDataReader 可用于访问结果的。

调用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

public:
 System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteReaderAsync(System::Threading::CancellationToken cancellationToken);

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

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

Public Function ExecuteReaderAsync (cancellationToken As CancellationToken) As Task(Of DbDataReader)

参数

cancellationToken: CancellationToken

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

Task<DbDataReader>

表示异步操作的任务。

例外

DbException

执行命令时出错。

ArgumentException

无效的 CommandBehavior 值。

OperationCanceledException

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

注解

托管提供程序实现程序必须在中ExecuteReaderAsync调用 ExecuteDbDataReaderAsync 。有关异步编程的详细信息，请参阅异步编程。

另请参阅

ADO.NET 概述

适用于

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Source:: DbCommand.cs

Source:: DbCommand.cs

Source:: DbCommand.cs

调用 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

public:
 System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);

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

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

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

参数

behavior: CommandBehavior

用于指定命令行为的枚举值之一。

cancellationToken: CancellationToken

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

Task<DbDataReader>

表示异步操作的任务。

例外

DbException

执行命令时出错。

ArgumentException

无效的 CommandBehavior 值。

OperationCanceledException

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

注解

托管提供程序实现程序必须在中ExecuteReaderAsync调用 ExecuteDbDataReaderAsync 。有关异步编程的详细信息，请参阅异步编程。

另请参阅

ADO.NET 概述

适用于

反馈

此页面是否有帮助？