DbCommand.ExecuteScalarAsync 方法

定義

命名空間:

System.Data.Common

組件:

netstandard.dll, System.Data.Common.dll

實作 的 ExecuteScalar()非同步版本，但會同步回傳 a Task ，阻擋呼叫執行緒。

多載

名稱	Description
ExecuteScalarAsync()	一個非同步版本的 ExecuteScalar()，執行指令並回傳第一個回傳結果集第一列的第一欄。 其他欄位、列和結果集則被忽略。 使用 CancellationToken.None 來調用 ExecuteScalarAsync(CancellationToken) 。
ExecuteScalarAsync(CancellationToken)	這是非同步版本的 ExecuteScalar()。 提供者應該透過適當的實作來覆蓋。 取消標記可選擇性地忽略。 預設實作會呼叫同步 ExecuteScalar() 方法並回傳已完成的任務，阻擋呼叫執行緒。 預設實作若傳遞已取消的取消標記，會回傳已取消的任務。 ExecuteScalar 拋出的異常會透過回傳的任務異常屬性來傳達。 在回傳任務完成前，不要呼叫物件的其他 DbCommand 方法和屬性。

備註

欲了解更多非同步程式設計的資訊，請參閱非同步程式設計。

ExecuteScalarAsync()

來源:

DbCommand.cs

一個非同步版本的 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)

傳回

Task<Object>

一個代表非同步操作的任務。

例外狀況

DbException

執行指令時發生錯誤。

備註

欲了解更多非同步程式設計的資訊，請參閱非同步程式設計。

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 ExecuteScalar()拋出的例外。

另請參閱

• ADO.NET 概觀

ExecuteScalarAsync(CancellationToken)

來源:

DbCommand.cs

這是非同步版本的 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

一個取消非同步操作的標記。

傳回

Task<Object>

一個代表非同步操作的任務。

例外狀況

DbException

執行指令時發生錯誤。

OperationCanceledException

取消令牌也被取消了。 此例外會儲存在回傳的任務中。

備註

欲了解更多非同步程式設計的資訊，請參閱非同步程式設計。

此方法在任務中儲存所有非使用例外，該方法的同步對應程式可拋出這些例外。 如果回傳的任務中儲存了例外，該例外會在等待任務時拋出。 使用例外錯誤，例如 ArgumentException，仍會同步拋出。 關於儲存的例外，請參見由 ExecuteScalar()拋出的例外。

另請參閱

• ADO.NET 概觀