SqlBatch.ExecuteScalarAsync(CancellationToken) 方法

定义

重要

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

的 ExecuteScalar()异步版本，它执行批处理并返回第一个返回的结果集中第一行的第一列。将忽略所有其他列、行和结果集。

public override System.Threading.Tasks.Task<object> ExecuteScalarAsync (System.Threading.CancellationToken cancellationToken = default);

override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>

Public Overrides Function ExecuteScalarAsync (Optional cancellationToken As CancellationToken = Nothing) As Task(Of Object)

用于取消异步操作的令牌。

第一个结果集中第一行的第一列。

SqlException

执行批处理时出错。

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

此方法受益于 ExecuteScalarAsync(CancellationToken)，该方法的所有预期异常也在此处适用。如果异常存储在返回的任务中，则在等待任务时将引发该异常。使用异常（如 ArgumentException）仍会同步引发。