SqlDataReader.NextResultAsync(CancellationToken) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
读取批处理 Transact-SQL 语句的结果时,异步版本的 NextResult()数据读取器将数据读取器提升到下一个结果。
The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. Exceptions will be reported via the returned Task object.
<p>For new development, use <a href="/sql/connect/ado-net/introduction-microsoft-data-sqlclient-namespace">Microsoft.Data.SqlClient</a>. This page documents System.Data.SqlClient.</p>
public:
override System::Threading::Tasks::Task<bool> ^ NextResultAsync(System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<bool> NextResultAsync(System.Threading.CancellationToken cancellationToken);
override this.NextResultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
Public Overrides Function NextResultAsync (cancellationToken As CancellationToken) As Task(Of Boolean)
参数
- cancellationToken
- CancellationToken
取消指令。
返回
表示异步操作的任务。
例外
在任务完成前多次为同一实例调用 NextResultAsync(CancellationToken) 一次。
Context Connection=true在连接字符串中指定。
执行命令文本时SQL Server返回错误。
取消令牌已取消。 此异常存储在返回的任务中。
注解
有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息,请参阅 Asynchronous Programming。
此方法存储在任务中,它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中,则等待任务时将引发该异常。 使用情况异常(例如 ArgumentException)仍会同步引发。 有关存储的异常,请参阅由 NextResult()..