SqlCommand.ExecuteScalarAsync(CancellationToken) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
异步版本，该版本 ExecuteScalar()异步执行查询，并返回查询返回的结果集中第一行的第一列。 忽略其他列或行。
取消令牌可用于请求在命令超时之前放弃操作。 异常将通过返回的任务对象报告。
public:
override System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<object> ExecuteScalarAsync(System.Threading.CancellationToken cancellationToken);override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>Public Overrides Function ExecuteScalarAsync (cancellationToken As CancellationToken) As Task(Of Object)参数
- cancellationToken
- CancellationToken
取消指令。
返回
表示异步操作的任务。
例外
如果设置为 SqlDbType，则使用二进制或 Value 以外的其他Stream项。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
设置为
-或-
在任务完成前多次为同一实例调用 ExecuteScalarAsync(CancellationToken) 一次。
-或-
在 SqlConnection 流式处理操作期间关闭或删除。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
-或-
Context Connection=true在连接字符串中指定。
流式处理操作期间发生错误StreamXmlReader或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
Stream XmlReader流式处理操作期间关闭或TextReader对象。 有关流式处理的详细信息，请参阅 SqlClient 流式处理支持。
取消令牌已取消。 此异常存储在返回的任务中。
注解
有关 .NET Framework Data Provider 中用于SQL Server的异步编程的详细信息，请参阅 Asynchronous Programming。
此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用情况异常（例如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅由 ExecuteScalar()..