SqlCommand.ExecuteReaderAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
启动此 SqlCommand描述的 Transact-SQL 语句或存储过程的异步执行。
重载
| ExecuteReaderAsync() |
ExecuteReader()的异步版本，它将 CommandText 发送到 Connection 并生成 SqlDataReader。 异常将通过返回的任务对象报告。 |
| ExecuteReaderAsync(CommandBehavior) |
ExecuteReader(CommandBehavior)的异步版本，它将 CommandText 发送到 Connection，并生成 SqlDataReader。 异常将通过返回的任务对象报告。 |
| ExecuteReaderAsync(CancellationToken) |
ExecuteReader()的异步版本，它将 CommandText 发送到 Connection 并生成 SqlDataReader。 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。 |
| ExecuteReaderAsync(CommandBehavior, CancellationToken) |
ExecuteReader(CommandBehavior)的异步版本，它将 CommandText 发送到 Connection，并生成 SqlDataReader 取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。 |
注解
有关适用于 SQL Server 的 .NET Framework 数据提供程序中的异步编程的详细信息，请参阅 异步编程。
ExecuteReaderAsync()
ExecuteReader()的异步版本，它将 CommandText 发送到 Connection 并生成 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)返回
表示异步操作的任务。
例外
二进制 或 VarBinary 以外的 SqlDbType 在 Value 设置为 Stream时使用。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
除 Char、NChar、NVarChar、VarChar或 Xml 以外的 SqlDbType 在 Value 设置为 TextReader时使用。
-或-
在任务完成之前，为同一实例多次调用 ExecuteReaderAsync() 一次。
-或-
流式处理操作期间关闭或删除 SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
连接字符串中指定了 Context Connection=true。
在流式处理操作期间，Stream、XmlReader 或 TextReader 对象中发生错误。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
流式处理操作期间关闭了 Stream、XmlReader 或 TextReader 对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
注解
有关适用于 SQL Server 的 .NET Framework 数据提供程序中的异步编程的详细信息，请参阅 异步编程。
此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用异常（如 ArgumentException）仍同步引发。 有关存储的异常，请参阅 ExecuteReader()引发的异常。
另请参阅
适用于
ExecuteReaderAsync(CommandBehavior)
ExecuteReader(CommandBehavior)的异步版本，它将 CommandText 发送到 Connection，并生成 SqlDataReader。 异常将通过返回的任务对象报告。
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) 在返回完整任务之前读取整行。
返回
表示异步操作的任务。
例外
二进制 或 VarBinary 以外的 SqlDbType 在 Value 设置为 Stream时使用。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
除 Char、NChar、NVarChar、VarChar或 Xml 以外的 SqlDbType 在 Value 设置为 TextReader时使用。
-或-
在任务完成之前，为同一实例多次调用 ExecuteReaderAsync(CommandBehavior) 一次。
-或-
流式处理操作期间关闭或删除 SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
连接字符串中指定了 Context Connection=true。
在流式处理操作期间，Stream、XmlReader 或 TextReader 对象中发生错误。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
流式处理操作期间关闭了 Stream、XmlReader 或 TextReader 对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
注解
有关适用于 SQL Server 的 .NET Framework 数据提供程序中的异步编程的详细信息，请参阅 异步编程。
此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用异常（如 ArgumentException）仍同步引发。 有关存储的异常，请参阅 ExecuteReader(CommandBehavior)引发的异常。
另请参阅
适用于
ExecuteReaderAsync(CancellationToken)
ExecuteReader()的异步版本，它将 CommandText 发送到 Connection 并生成 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
取消指令。
返回
表示异步操作的任务。
例外
二进制 或 VarBinary 以外的 SqlDbType 在 Value 设置为 Stream时使用。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
除 Char、NChar、NVarChar、VarChar或 Xml 以外的 SqlDbType 在 Value 设置为 TextReader时使用。
-或-
在任务完成之前，为同一实例多次调用 ExecuteReaderAsync(CommandBehavior, CancellationToken) 一次。
-或-
流式处理操作期间关闭或删除 SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
连接字符串中指定了 Context Connection=true。
在流式处理操作期间，Stream、XmlReader 或 TextReader 对象中发生错误。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
流式处理操作期间关闭了 Stream、XmlReader 或 TextReader 对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
取消令牌已取消。 此异常存储在返回的任务中。
注解
有关适用于 SQL Server 的 .NET Framework 数据提供程序中的异步编程的详细信息，请参阅 异步编程。
此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用异常（如 ArgumentException）仍同步引发。 有关存储的异常，请参阅 ExecuteReader()引发的异常。
另请参阅
适用于
ExecuteReaderAsync(CommandBehavior, CancellationToken)
ExecuteReader(CommandBehavior)的异步版本，它将 CommandText 发送到 Connection，并生成 SqlDataReader
取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。
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
取消指令。
返回
表示异步操作的任务。
例外
二进制 或 VarBinary 以外的 SqlDbType 在 Value 设置为 Stream时使用。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
除 Char、NChar、NVarChar、VarChar或 Xml 以外的 SqlDbType 在 Value 设置为 TextReader时使用。
-或-
在任务完成之前，为同一实例多次调用 ExecuteReaderAsync(CommandBehavior, CancellationToken) 一次。
-或-
流式处理操作期间关闭或删除 SqlConnection。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
连接字符串中指定了 Context Connection=true。
在流式处理操作期间，Stream、XmlReader 或 TextReader 对象中发生错误。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
流式处理操作期间关闭了 Stream、XmlReader 或 TextReader 对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
取消令牌已取消。 此异常存储在返回的任务中。
注解
有关适用于 SQL Server 的 .NET Framework 数据提供程序中的异步编程的详细信息，请参阅 异步编程。
此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用异常（如 ArgumentException）仍同步引发。 有关存储的异常，请参阅 ExecuteReader(CommandBehavior)引发的异常。
