DbCommand.ExecuteScalarAsync メソッド

定義

名前空間:

System.Data.Common

アセンブリ:

System.Data.Common.dll

アセンブリ:

System.Data.dll

アセンブリ:

netstandard.dll

ExecuteScalar() の非同期バージョンを実装しますが、スレッドの呼び出しをブロックして、Task を同期的に返します。

オーバーロード

ExecuteScalarAsync()	非同期バージョン 。 ExecuteScalar()コマンドを実行し、最初に返された結果セットの最初の行の最初の列を返します。 その他の列、行、結果セットはすべて無視されます。 CancellationToken.None を使用して、ExecuteScalarAsync(CancellationToken) を呼び出します。
ExecuteScalarAsync(CancellationToken)	これは ExecuteScalar() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 オプションで、キャンセル トークンを無視できます。 既定の実装は ExecuteScalar() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 既定の実装は、既に取り消されたキャンセル トークンを渡した場合、取り消されたタスクを返します。 ExecuteScalar によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。 返されたタスクが完了するまで DbCommand オブジェクトの他のメソッドとプロパティを呼び出さないでください。

注釈

非同期プログラミングの詳細については、「 非同期プログラミング」を参照してください。

ExecuteScalarAsync()

非同期バージョン 。 ExecuteScalar()コマンドを実行し、最初に返された結果セットの最初の行の最初の列を返します。 その他の列、行、結果セットはすべて無視されます。

CancellationToken.None を使用して、ExecuteScalarAsync(CancellationToken) を呼び出します。

public:
 System::Threading::Tasks::Task<System::Object ^> ^ ExecuteScalarAsync();

public System.Threading.Tasks.Task<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

コマンドの実行中にエラーが発生しました。

注釈

非同期プログラミングの詳細については、「 非同期プログラミング」を参照してください。

こちらもご覧ください

• ADO.NET の概要

ExecuteScalarAsync(CancellationToken)

これは ExecuteScalar() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 オプションで、キャンセル トークンを無視できます。

既定の実装は ExecuteScalar() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 既定の実装は、既に取り消されたキャンセル トークンを渡した場合、取り消されたタスクを返します。 ExecuteScalar によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。

返されたタスクが完了するまで 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);

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

コマンドの実行中にエラーが発生しました。

注釈

非同期プログラミングの詳細については、「 非同期プログラミング」を参照してください。

こちらもご覧ください

• ADO.NET の概要