DbDataReader.ReadAsync 方法

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

使读取器异步前进到结果集中的下一条记录。

重载

ReadAsync()	使读取器异步前进到结果集中的下一条记录。
ReadAsync(CancellationToken)	使读取器异步前进到结果集中的下一条记录。

注解

有关异步编程的详细信息，请参阅 异步编程。

ReadAsync()

Source:

DbDataReader.cs

使读取器异步前进到结果集中的下一条记录。

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

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

member this.ReadAsync : unit -> System.Threading.Tasks.Task<bool>

Public Function ReadAsync () As Task(Of Boolean)

返回

Task<Boolean>

一个 Task<TResult>，如果有更多的行，则其 Result 属性为 true，如果没有，则为 false。

例外

DbException

执行命令文本时出现的一个错误。

注解

此异步方法的默认实现调用其同步对应方法并返回已完成的 Task，这可能会阻止调用线程。

支持 异步编程 的数据提供程序应使用异步 I/O 操作替代默认实现。

当返回任务还未完成时， DbDataReader 对象的其他方法和属性不应调用 。

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

另请参阅

• ADO.NET 概述

ReadAsync(CancellationToken)

Source:

DbDataReader.cs

使读取器异步前进到结果集中的下一条记录。

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

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

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

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

参数

cancellationToken

CancellationToken

取消指示。

返回

Task<Boolean>

一个 Task<TResult>，如果有更多的行，则其 Result 属性为 true，如果没有，则为 false。

例外

DbException

执行命令文本时出现的一个错误。

OperationCanceledException

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

注解

此异步方法的默认实现调用其同步对应方法并返回已完成的 Task，这可能会阻止调用线程。 如果传递了已取消的取消令牌，则默认实现还会返回已取消的任务。

支持 异步编程 的数据提供程序应使用异步 I/O 操作替代默认实现。

该方法可用于请求操作之前接受取消标记。 实现可能会忽略该请求。

当返回任务还未完成时， DbDataReader 对象的其他方法和属性不应调用 。

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

另请参阅

• ADO.NET 概述