DbCommand.ExecuteScalarAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ExecuteScalar()の非同期バージョンを実装しますが、Taskを同期的に返し、呼び出し元のスレッドをブロックします。
オーバーロード
| 名前 | 説明 |
|---|---|
| ExecuteScalarAsync() |
コマンドを実行し、最初に返された結果セットの最初の行の最初の列を返す、 ExecuteScalar()の非同期バージョン。 他のすべての列、行、結果セットは無視されます。 CancellationToken.None を使用して ExecuteScalarAsync(CancellationToken) を呼び出します。 |
| ExecuteScalarAsync(CancellationToken) |
これは、 ExecuteScalar()の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 キャンセル トークンは、必要に応じて無視できます。 既定の実装では、同期 ExecuteScalar() メソッドが呼び出され、完了したタスクが返され、呼び出し元のスレッドがブロックされます。 既定の実装では、既に取り消されたキャンセル トークンが渡された場合、取り消されたタスクが返されます。 ExecuteScalar によってスローされた例外は、返されたタスク例外プロパティを介して伝達されます。 返された Task が完了するまで、 |
注釈
非同期プログラミングの詳細については、「 非同期プログラミング」を参照してください。
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 によってスローされた例外は、返されたタスク例外プロパティを介して伝達されます。
返された Task が完了するまで、 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()によってスローされる例外を参照してください。