SqlCommand.ExecuteNonQueryAsync(CancellationToken) 方法

定义

重要

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

的 ExecuteNonQuery() 异步版本，它针对连接执行 Transact-SQL 语句并返回受影响的行数。取消标记可用于在命令超时超过前请求放弃操作。将通过返回的任务对象报告异常。

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

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

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

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

取消指示。

Task<Int32>

表示异步操作的任务。

当 SqlDbType 设置为 Stream 时Value，使用了 Binary 或 VarBinary 以外的。有关流式处理的详细信息，请参阅 SqlClient 流支持。

- 或 -

设置为 SqlDbType 时Value TextReader ，使用了 Char、NChar、NVarChar、VarChar 或 Xml 以外的。

-或-

当 SqlDbType 设置为 XmlReader 时Value，使用了 Xml 以外的。

在完成任务前，为同一个实例多次调用 ExecuteNonQueryAsync(CancellationToken)。

- 或 -

流式处理操作期间关闭或删除了 SqlConnection。有关流式处理的详细信息，请参阅 SqlClient 流支持。

SqlException

执行命令文本时，SQL Server 返回了一个错误。

- 或 -

流式处理操作期间发生了超时。有关流式处理的详细信息，请参阅 SqlClient 流支持。

IOException

在流式处理操作期间， XmlReader 或 TextReader 对象中Stream发生错误。有关流式处理的详细信息，请参阅 SqlClient 流支持。

在 Stream 流式处理操作期间关闭了、 XmlReader 或 TextReader 对象。有关流式处理的详细信息，请参阅 SqlClient 流支持。

有关 .NET Framework Data Provider for SQL Server 中异步编程的详细信息，请参阅异步编程。

注意

对于服务器上长时间运行的查询，请考虑使用 ExecuteNonQuery ，因为存在通过取消令牌取消查询的已知问题。此外，请考虑使用 Cancel 方法取消执行。