SqlCommand.ExecuteNonQueryAsync(CancellationToken) 方法

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.SqlClient.dll

套件:

System.Data.SqlClient v4.8.6

的 ExecuteNonQuery()異步版本，它會針對連接執行 Transact-SQL 語句，並傳回受影響的數據列數目。 取消語彙基元可用於要求在命令逾時之前捨棄作業。 例外狀況將經由傳回的 Task 物件回報。

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)

參數

cancellationToken

CancellationToken

取消指令。

傳回

Task<Int32>

表示非同步作業的工作。

例外狀況

InvalidCastException

當 Value 設為 Stream 時，使用 Binary 或 VarBinary 以外的 SqlDbType。 如需串流的詳細資訊，請參閱 SqlClient 串流支援。

-或-

SqlDbType當 設定TextReader為 時Value，會使用 Char、NChar、NVarChar、VarChar 或 Xml 以外的 。

-或-

當 Value 設定為 XmlReader 時，使用 Xml 以外的 SqlDbType。

InvalidOperationException

在工作完成前，對同一個執行個體呼叫 ExecuteNonQueryAsync(CancellationToken) 不止一次。

-或-

在串流作業期間已關閉或卸除的 SqlConnection。 如需串流的詳細資訊，請參閱 SqlClient 串流支援。

-或-

在連接字串中指定了 Context Connection=true。

SqlException

SQL Server 於執行命令文字時傳回錯誤。

-或-

串流作業期間發生逾時。 如需串流的詳細資訊，請參閱 SqlClient 串流支援。

IOException

Stream、XmlReader 或 TextReader 物件在串流作業期間發生錯誤。 如需串流的詳細資訊，請參閱 SqlClient 串流支援。

ObjectDisposedException

Stream、XmlReader 或 TextReader 物件在串流作業期間已關閉。 如需串流的詳細資訊，請參閱 SqlClient 串流支援。

OperationCanceledException

取消標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

如需 .NET Framework Data Provider for SQL Server 中異步程式設計的詳細資訊，請參閱異步程序設計。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException仍會同步擲回。 如需預存例外狀況，請參閱 擲回的 ExecuteNonQuery()例外狀況。

另請參閱

• ADO.NET 概觀 \(部分機器翻譯\)