SqlCommand.ExecuteReaderAsync 方法

定义

命名空间:

System.Data.SqlClient

程序集:

System.Data.dll

启动由此描述 SqlCommand的 Transact-SQL 语句或存储过程的异步执行。

重载

名称	说明
ExecuteReaderAsync()	的异步版本ExecuteReader()，用于将它发送到CommandTextConnection并生成一个 SqlDataReader。 异常将通过返回的任务对象报告。
ExecuteReaderAsync(CommandBehavior)	一个异步版本，用于向 <a0/a0> 发送并生成一个 。 异常将通过返回的任务对象报告。
ExecuteReaderAsync(CancellationToken)	的异步版本ExecuteReader()，用于将它发送到CommandTextConnection并生成一个 SqlDataReader。 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。
ExecuteReaderAsync(CommandBehavior, CancellationToken)	一个异步版本，该版本 将发送到 并生成 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。

ExecuteReaderAsync()

的异步版本ExecuteReader()，用于将它发送到CommandTextConnection并生成一个 SqlDataReader。 异常将通过返回的任务对象报告。

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync();

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync();

override this.ExecuteReaderAsync : unit -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

返回

Task<SqlDataReader>

表示异步操作的任务。

例外

InvalidCastException

如果设置为 SqlDbType，则使用二进制或 Value 以外的其他Stream项。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

-或-

设置为 /a0> 时使用了除 Char、NChar、NVarChar、VarChar 或 Xml 以外的其他项。

-或-

设置为SqlDbType时使用了 ValueXmlReader项。

ArgumentException

无效 CommandBehavior 值。

InvalidOperationException

在任务完成前多次为同一实例调用 ExecuteReaderAsync() 一次。

-或-

在 SqlConnection 流式处理操作期间关闭或删除。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

-或-

Context Connection=true在连接字符串中指定。

SqlException

执行命令文本时SQL Server返回错误。

-或-

流式处理操作期间发生超时。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

IOException

流式处理操作期间发生错误StreamXmlReader或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

ObjectDisposedException

Stream XmlReader流式处理操作期间关闭或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。

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

另请参阅

• ADO.NET 概述

ExecuteReaderAsync(CommandBehavior)

一个异步版本，用于向 <a0/a0> 发送并生成一个 。 异常将通过返回的任务对象报告。

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

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Data.CommandBehavior behavior);

override this.ExecuteReaderAsync : System.Data.CommandBehavior -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

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

参数

behavior

CommandBehavior

语句执行和数据检索的选项。 如果设置为 Default， ReadAsync(CancellationToken) 请在返回完整任务之前读取整行。

返回

Task<SqlDataReader>

表示异步操作的任务。

例外

InvalidCastException

如果设置为 SqlDbType，则使用二进制或 Value 以外的其他Stream项。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

-或-

设置为 /a0> 时使用了除 Char、NChar、NVarChar、VarChar 或 Xml 以外的其他项。

-或-

设置为SqlDbType时使用了 ValueXmlReader项。

ArgumentException

无效 CommandBehavior 值。

InvalidOperationException

在任务完成前多次为同一实例调用 ExecuteReaderAsync(CommandBehavior) 一次。

-或-

在 SqlConnection 流式处理操作期间关闭或删除。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

-或-

Context Connection=true在连接字符串中指定。

SqlException

执行命令文本时SQL Server返回错误。

-或-

流式处理操作期间发生超时。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

IOException

流式处理操作期间发生错误StreamXmlReader或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

ObjectDisposedException

Stream XmlReader流式处理操作期间关闭或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。

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

另请参阅

• ADO.NET 概述

ExecuteReaderAsync(CancellationToken)

的异步版本ExecuteReader()，用于将它发送到CommandTextConnection并生成一个 SqlDataReader。

取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。

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

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Threading.CancellationToken cancellationToken);

override this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

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

参数

cancellationToken

CancellationToken

取消指令。

返回

Task<SqlDataReader>

表示异步操作的任务。

例外

InvalidCastException

如果设置为 SqlDbType，则使用二进制或 Value 以外的其他Stream项。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

-或-

设置为 /a0> 时使用了除 Char、NChar、NVarChar、VarChar 或 Xml 以外的其他项。

-或-

设置为SqlDbType时使用了 ValueXmlReader项。

ArgumentException

无效 CommandBehavior 值。

InvalidOperationException

在任务完成前多次为同一实例调用 ExecuteReaderAsync(CommandBehavior, CancellationToken) 一次。

-或-

在 SqlConnection 流式处理操作期间关闭或删除。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

-或-

Context Connection=true在连接字符串中指定。

SqlException

执行命令文本时SQL Server返回错误。

-或-

流式处理操作期间发生超时。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

IOException

流式处理操作期间发生错误StreamXmlReader或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

ObjectDisposedException

Stream XmlReader流式处理操作期间关闭或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

OperationCanceledException

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

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。

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

另请参阅

• ADO.NET 概述

ExecuteReaderAsync(CommandBehavior, CancellationToken)

一个异步版本，该版本 将发送到 并生成

取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。

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

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

override this.ExecuteReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

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

参数

behavior

CommandBehavior

语句执行和数据检索的选项。 如果设置为 Default， ReadAsync(CancellationToken) 请在返回完整任务之前读取整行。

cancellationToken

CancellationToken

取消指令。

返回

Task<SqlDataReader>

表示异步操作的任务。

例外

InvalidCastException

如果设置为 SqlDbType，则使用二进制或 Value 以外的其他Stream项。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

-或-

设置为 /a0> 时使用了除 Char、NChar、NVarChar、VarChar 或 Xml 以外的其他项。

-或-

设置为SqlDbType时使用了 ValueXmlReader项。

ArgumentException

无效 CommandBehavior 值。

InvalidOperationException

在任务完成前多次为同一实例调用 ExecuteReaderAsync(CommandBehavior, CancellationToken) 一次。

-或-

在 SqlConnection 流式处理操作期间关闭或删除。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

-或-

Context Connection=true在连接字符串中指定。

SqlException

执行命令文本时SQL Server返回错误。

-或-

流式处理操作期间发生超时。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

IOException

流式处理操作期间发生错误StreamXmlReader或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

ObjectDisposedException

Stream XmlReader流式处理操作期间关闭或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

OperationCanceledException

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

注解

有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。

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

另请参阅

• ADO.NET 概述