DbCommand.ExecuteScalarAsync メソッド

定義

名前空間:

System.Data.Common

アセンブリ:

System.Data.Common.dll

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

オーバーロード

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

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 の概要