DbCommand.ExecuteScalarAsync 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
实现异步版本的 ExecuteScalar()，但会 Task 同步返回阻止调用线程。
重载
| 名称 | 说明 |
|---|---|
| ExecuteScalarAsync() |
一个异步版本，该版本 ExecuteScalar()执行命令并返回第一个返回的结果集中第一行的第一列。 将忽略所有其他列、行和结果集。 使用 ExecuteScalarAsync(CancellationToken) CancellationToken.None 调用。 |
| ExecuteScalarAsync(CancellationToken) |
这是 .的 ExecuteScalar()异步版本。 提供程序应使用适当的实现替代。 可以选择忽略取消令牌。 默认实现调用同步 ExecuteScalar() 方法并返回已完成的任务，从而阻止调用线程。 如果传递已取消的取消令牌，则默认实现将返回已取消的任务。 ExecuteScalar 引发的异常将通过返回的任务异常属性进行通信。 在返回的任务完成之前，请勿调用对象的其他方法和属性 |
注解
有关异步编程的详细信息，请参阅 异步编程。
ExecuteScalarAsync()
- Source:
- DbCommand.cs
- Source:
- DbCommand.cs
- Source:
- DbCommand.cs
- Source:
- DbCommand.cs
- Source:
- DbCommand.cs
一个异步版本，该版本 ExecuteScalar()执行命令并返回第一个返回的结果集中第一行的第一列。 将忽略所有其他列、行和结果集。
使用 ExecuteScalarAsync(CancellationToken) CancellationToken.None 调用。
public:
System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync();public System.Threading.Tasks.Task<object> ExecuteScalarAsync();public System.Threading.Tasks.Task<object?> ExecuteScalarAsync();member this.ExecuteScalarAsync : unit -> System.Threading.Tasks.Task<obj>Public Function ExecuteScalarAsync () As Task(Of Object)返回
表示异步操作的任务。
例外
执行命令时出错。
注解
有关异步编程的详细信息，请参阅 异步编程。
此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用情况异常（例如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅由 ExecuteScalar()..
另请参阅
适用于
ExecuteScalarAsync(CancellationToken)
- Source:
- DbCommand.cs
- Source:
- DbCommand.cs
- Source:
- DbCommand.cs
- Source:
- DbCommand.cs
- Source:
- DbCommand.cs
这是 .的 ExecuteScalar()异步版本。 提供程序应使用适当的实现替代。 可以选择忽略取消令牌。
默认实现调用同步 ExecuteScalar() 方法并返回已完成的任务，从而阻止调用线程。 如果传递已取消的取消令牌，则默认实现将返回已取消的任务。 ExecuteScalar 引发的异常将通过返回的任务异常属性进行通信。
在返回的任务完成之前，请勿调用对象的其他方法和属性 DbCommand 。
public:
virtual System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<object> ExecuteScalarAsync(System.Threading.CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<object?> ExecuteScalarAsync(System.Threading.CancellationToken cancellationToken);abstract member ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>
override this.ExecuteScalarAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<obj>Public Overridable Function ExecuteScalarAsync (cancellationToken As CancellationToken) As Task(Of Object)参数
- cancellationToken
- CancellationToken
用于取消异步操作的令牌。
返回
表示异步操作的任务。
例外
执行命令时出错。
取消令牌已取消。 此异常存储在返回的任务中。
注解
有关异步编程的详细信息，请参阅 异步编程。
此方法存储在任务中，它返回该方法的同步对应项可以引发的所有非使用异常。 如果异常存储在返回的任务中，则等待任务时将引发该异常。 使用情况异常（例如 ArgumentException）仍会同步引发。 有关存储的异常，请参阅由 ExecuteScalar()..
