DbCommand.ExecuteReaderAsync 方法

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

的 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

的 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

的 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

的 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 。 有关异步编程的详细信息，请参阅 异步编程。

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

另请参阅

• ADO.NET 概述

ExecuteReaderAsync(CommandBehavior, CancellationToken)

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 。 有关异步编程的详细信息，请参阅 异步编程。

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

另请参阅

• ADO.NET 概述