DbCommand.ExecuteNonQueryAsync 方法

定义

命名空间:

System.Data.Common

程序集:

System.Data.Common.dll

此方法实现 ExecuteNonQuery() 的异步版本，但阻塞调用线程时同步返回 Task。

重载

ExecuteNonQueryAsync(CancellationToken)	这是 ExecuteNonQuery() 的异步版本。 提供程序应使用合适的实现进行重写。 可选择性忽略取消标记。 默认实现调用同步 ExecuteNonQuery() 方法并返回已完成任务，以便阻止调用线程。 如果传递到已取消的取消标记，则默认实现将返回已取消的任务。 ExecuteNonQuery() 引发的异常将通过任务异常属性传递。 在返回的任务完成前，不要调用 DbCommand 对象的其他方法和属性。
ExecuteNonQueryAsync()	的 ExecuteNonQuery()异步版本，针对其连接对象执行命令，返回受影响的行数。 通过 CancellationToken.None 调用 ExecuteNonQueryAsync(CancellationToken)。

注解

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

ExecuteNonQueryAsync(CancellationToken)

Source:

DbCommand.cs

这是 ExecuteNonQuery() 的异步版本。 提供程序应使用合适的实现进行重写。 可选择性忽略取消标记。

默认实现调用同步 ExecuteNonQuery() 方法并返回已完成任务，以便阻止调用线程。 如果传递到已取消的取消标记，则默认实现将返回已取消的任务。 ExecuteNonQuery() 引发的异常将通过任务异常属性传递。

在返回的任务完成前，不要调用 DbCommand 对象的其他方法和属性。

public:
 virtual System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<int> ExecuteNonQueryAsync (System.Threading.CancellationToken cancellationToken);

abstract member ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
override this.ExecuteNonQueryAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

Public Overridable Function ExecuteNonQueryAsync (cancellationToken As CancellationToken) As Task(Of Integer)

参数

cancellationToken

CancellationToken

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

返回

Task<Int32>

表示异步操作的任务。

例外

DbException

执行命令时出错。

OperationCanceledException

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

注解

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

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

另请参阅

• ADO.NET 概述

ExecuteNonQueryAsync()

Source:

DbCommand.cs

的 ExecuteNonQuery()异步版本，针对其连接对象执行命令，返回受影响的行数。

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

public:
 System::Threading::Tasks::Task<int> ^ ExecuteNonQueryAsync();

public System.Threading.Tasks.Task<int> ExecuteNonQueryAsync ();

member this.ExecuteNonQueryAsync : unit -> System.Threading.Tasks.Task<int>

Public Function ExecuteNonQueryAsync () As Task(Of Integer)

返回

Task<Int32>

表示异步操作的任务。

例外

DbException

执行命令时出错。

注解

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

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

另请参阅

• ADO.NET 概述