SqlDataReader.ReadAsync(CancellationToken) 方法

定义

重要

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

Read() 的异步版本，将 SqlDataReader 前移到下一条记录。

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

public:
 override System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<bool> ReadAsync (System.Threading.CancellationToken cancellationToken);

override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overrides Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

取消指示。

表示异步操作的任务。

在完成任务前，为同一个实例多次调用 ReadAsync(CancellationToken)。

SqlException

执行命令文本时，SQL Server 返回了一个错误。

behavior如果的 ExecuteReaderAsync 参数设置为 Default，ReadAsync则会在返回 Task 之前读取整行。

有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息（包括代码示例），请参阅异步编程。

注意

(二进制/文本) 读取大型数据时，建议使用 Read 以获得最佳性能。