SqlDataReader.NextResultAsync(CancellationToken) 方法

定义

NextResult()异步版本,在读取批处理 Transact-SQL 语句的结果时,它将数据读取器推进到下一个结果。

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

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

参数

cancellationToken
CancellationToken

取消指示。

返回

表示异步操作的任务。

例外

在完成任务前,为同一个实例多次调用 NextResultAsync(CancellationToken)

在连接字符串中指定 Context Connection=true

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

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

注解

有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息,请参阅异步编程

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

适用于

产品 版本
.NET Core 1.0, Core 1.1, 6 (package-provided), 7 (package-provided), 8 (package-provided), 9 (package-provided)
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0 (package-provided)

另请参阅