DbCommand.ExecuteScalarAsync 方法

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

实现一个 ExecuteScalar() 的异步版本，但阻塞调用线程时同步返回一个 Task。

重载

ExecuteScalarAsync()	的 ExecuteScalar()异步版本，它执行命令并返回第一个返回的结果集中第一行的第一列。 将忽略所有其他列、行和结果集。 通过 CancellationToken.None 调用 ExecuteScalarAsync(CancellationToken)。
ExecuteScalarAsync(CancellationToken)	这是 ExecuteScalar() 的异步版本。 提供程序应使用合适的实现进行重写。 可选择性忽略取消标记。 默认实现调用同步 ExecuteScalar() 方法并返回已完成任务，以便阻止调用线程。 如果传递到已取消的取消标记，则默认实现将返回已取消的任务。 ExecuteScalar 引发的异常将通过返回的任务异常属性传递。 在返回的任务完成前，不要调用 DbCommand 对象的其他方法和属性。

注解

有关异步编程的详细信息，请参阅 异步编程。

ExecuteScalarAsync()

Source:

DbCommand.cs

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

通过 CancellationToken.None 调用 ExecuteScalarAsync(CancellationToken)。

public:
 System::Threading::Tasks::Task<System::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)

返回

Task<Object>

表示异步操作的任务。

例外

DbException

执行命令时出错。

注解

有关异步编程的详细信息，请参阅 异步编程。

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

另请参阅

• ADO.NET 概述

ExecuteScalarAsync(CancellationToken)

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);

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

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

返回

Task<Object>

表示异步操作的任务。

例外

DbException

执行命令时出错。

OperationCanceledException

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

注解

有关异步编程的详细信息，请参阅 异步编程。

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

另请参阅

• ADO.NET 概述