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