SqlCommand.ExecuteReaderAsync 方法

定义

命名空间:: Microsoft.Data.SqlClient

程序集:: Microsoft.Data.SqlClient.dll

包:: Microsoft.Data.SqlClient v1.0.19269.1

包:: Microsoft.Data.SqlClient v1.1.4

包:: Microsoft.Data.SqlClient v2.0.1

包:: Microsoft.Data.SqlClient v2.1.4

包:: Microsoft.Data.SqlClient v3.0.1

包:: Microsoft.Data.SqlClient v3.1.0

包:: Microsoft.Data.SqlClient v4.0.1

包:: Microsoft.Data.SqlClient v4.1.0

包:: Microsoft.Data.SqlClient v5.0.0

包:: Microsoft.Data.SqlClient v5.1.0

包:: Microsoft.Data.SqlClient v5.2.0

包:: Microsoft.Data.SqlClient v6.0.2

包:: Microsoft.Data.SqlClient v6.1.3

包:: Microsoft.Data.SqlClient v7.0.1

重要

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

重载

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

ExecuteReaderAsync()

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

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

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

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

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

Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

Task<SqlDataReader>

表示异步作的任务。

例外

InvalidCastException

SqlDbType设置为时使用的其他Binary项或VarBinary已用Value到 Stream。有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
除其他项SqlDbType外，CharNCharNVarChar或VarChar设置为Xml时使用Value。TextReader
设置为时SqlDbTypeXml使用的其他Value项XmlReader。

ArgumentException

无效 CommandBehavior 值。

InvalidOperationException

在任务完成前多次为同一实例调用 ExecuteReaderAsync() 一次。
在 SqlConnection 流式处理操作期间关闭或删除。有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

SqlException

执行命令文本时SQL Server返回错误。
流式处理操作期间发生超时。有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

IOException

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

ObjectDisposedException

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

注解

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

注释

对于服务器上长时间运行的查询，请考虑 ExecuteReader 使用由于通过取消令牌取消查询的已知问题。此外，请考虑使用 Cancel 该方法取消执行。

适用于

ExecuteReaderAsync(CommandBehavior)

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

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

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

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

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

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

参数

behavior: CommandBehavior

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

Task<SqlDataReader>

表示异步作的任务。

例外

InvalidCastException

SqlDbType设置为时使用的其他Binary项或VarBinary已用Value到 Stream。有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
除其他项SqlDbType外，CharNCharNVarChar或VarChar设置为Xml时使用Value。TextReader
设置为时SqlDbTypeXml使用的其他Value项XmlReader。

ArgumentException

无效 CommandBehavior 值。

InvalidOperationException

在任务完成前多次为同一实例调用 ExecuteReaderAsync(CommandBehavior) 一次。
SqlConnection 在流式处理操作期间关闭或删除。有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

SqlException

执行命令文本时SQL Server返回错误。
流式处理操作期间发生超时。有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

IOException

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

ObjectDisposedException

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

注解

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

适用于

ExecuteReaderAsync(CancellationToken)

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

的异步版本ExecuteReader()，用于将它发送到CommandText Connection并生成一个 SqlDataReader。取消令牌可用于请求在命令超时之前放弃操作。异常将通过返回的任务对象报告。

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

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

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

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

参数

cancellationToken: CancellationToken

取消指令。

Task<SqlDataReader>

表示异步作的任务。

例外

InvalidCastException

SqlDbType设置为时使用的其他Binary项或VarBinary已用Value到 Stream。有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
除其他项SqlDbType外，CharNCharNVarChar或VarChar设置为Xml时使用Value。TextReader
设置为时SqlDbTypeXml使用的其他Value项XmlReader。

ArgumentException

无效 CommandBehavior 值。

InvalidOperationException

在任务完成前多次为同一实例调用 ExecuteReaderAsync(CommandBehavior, CancellationToken) 一次。
在 SqlConnection 流式处理操作期间关闭或删除。有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

SqlException

执行命令文本时SQL Server返回错误。
流式处理操作期间发生超时。有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

IOException

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

ObjectDisposedException

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

注解

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

适用于

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

异步版本的将发送到 /> 并生成取消令牌，用于请求在命令超时之前放弃操作。异常将通过返回的任务对象报告。

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

public System.Threading.Tasks.Task<Microsoft.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<Microsoft.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设置为时使用的其他Binary项或VarBinary已用Value到 Stream。有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
除其他项SqlDbType外，CharNCharNVarChar或VarChar设置为Xml时使用Value。TextReader
设置为时SqlDbTypeXml使用的其他Value项XmlReader。

ArgumentException

无效 CommandBehavior 值。

InvalidOperationException

在任务完成前多次为同一实例调用 ExecuteReaderAsync(CommandBehavior, CancellationToken) 一次。
在 SqlConnection 流式处理操作期间关闭或删除。有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

SqlException

执行命令文本时SQL Server返回错误。
流式处理操作期间发生超时。有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。

IOException

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

ObjectDisposedException

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

注解

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

适用于