DbCommand.ExecuteNonQueryAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
此方法實作了 的 ExecuteNonQuery()非同步版本，但會同步回傳 a Task ，阻擋呼叫執行緒。
多載
| 名稱 | Description |
|---|---|
| ExecuteNonQueryAsync(CancellationToken) |
這是非同步版本的 ExecuteNonQuery()。 提供者應該透過適當的實作來覆蓋。 取消標記可選擇性地忽略。 預設實作會呼叫同步 ExecuteNonQuery() 方法並回傳已完成的任務，阻擋呼叫執行緒。 預設實作若傳遞已取消的取消標記，會回傳已取消的任務。 所 ExecuteNonQuery() 拋出的異常會透過回傳的 Task Exception 屬性來傳達。 在回傳任務完成前，不要呼叫物件的其他 |
| ExecuteNonQueryAsync() |
非同步版本 ExecuteNonQuery()的 ，該指令會對其連接物件執行指令，並回傳受影響的列數。 使用 CancellationToken.None 來調用 ExecuteNonQueryAsync(CancellationToken) 。 |
備註
欲了解更多非同步程式設計的資訊，請參閱非同步程式設計。
ExecuteNonQueryAsync(CancellationToken)
這是非同步版本的 ExecuteNonQuery()。 提供者應該透過適當的實作來覆蓋。 取消標記可選擇性地忽略。
預設實作會呼叫同步 ExecuteNonQuery() 方法並回傳已完成的任務，阻擋呼叫執行緒。 預設實作若傳遞已取消的取消標記，會回傳已取消的任務。 所 ExecuteNonQuery() 拋出的異常會透過回傳的 Task Exception 屬性來傳達。
在回傳任務完成前，不要呼叫物件的其他 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
一個取消非同步操作的標記。
傳回
一個代表非同步操作的任務。
例外狀況
執行指令時發生錯誤。
取消令牌也被取消了。 此例外會儲存在回傳的任務中。
備註
欲了解更多非同步程式設計的資訊，請參閱非同步程式設計。
此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 ExecuteNonQuery()拋出的例外。
另請參閱
適用於
ExecuteNonQueryAsync()
非同步版本 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)傳回
一個代表非同步操作的任務。
例外狀況
執行指令時發生錯誤。
備註
欲了解更多非同步程式設計的資訊，請參閱非同步程式設計。
此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 ExecuteNonQuery()拋出的例外。