DbDataReader.ReadAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
リーダーを結果セット内の次のレコードに非同期的に進めます。
オーバーロード
| 名前 | 説明 |
|---|---|
| ReadAsync() |
リーダーを結果セット内の次のレコードに非同期的に進めます。 |
| ReadAsync(CancellationToken) |
リーダーを結果セット内の次のレコードに非同期的に進めます。 |
注釈
非同期プログラミングの詳細については、「 非同期プログラミング」を参照してください。
ReadAsync()
リーダーを結果セット内の次のレコードに非同期的に進めます。
public:
System::Threading::Tasks::Task<bool> ^ ReadAsync();public System.Threading.Tasks.Task<bool> ReadAsync();member this.ReadAsync : unit -> System.Threading.Tasks.Task<bool>Public Function ReadAsync () As Task(Of Boolean)返品
行が多い場合はResultプロパティがtrueTask<TResult>。存在しない場合はfalse。
例外
コマンド テキストの実行中にエラーが発生しました。
注釈
この非同期メソッドの既定の実装では、対応する同期メソッドが呼び出され、完了した Task が返され、呼び出し元のスレッドがブロックされる可能性があります。
非同期プログラミングをサポートするデータ プロバイダーは、非同期 I/O 操作を使用して既定の実装をオーバーライドする必要があります。
返された Task がまだ完了していない間は、DbDataReader オブジェクトの他のメソッドとプロパティを呼び出さないでください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 Read()によってスローされる例外を参照してください。
こちらもご覧ください
適用対象
ReadAsync(CancellationToken)
リーダーを結果セット内の次のレコードに非同期的に進めます。
public:
virtual System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);public virtual System.Threading.Tasks.Task<bool> ReadAsync(System.Threading.CancellationToken cancellationToken);abstract member ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overridable Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)パラメーター
- cancellationToken
- CancellationToken
取り消し命令。
返品
行が多い場合はResultプロパティがtrueTask<TResult>。存在しない場合はfalse。
例外
コマンド テキストの実行中にエラーが発生しました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
この非同期メソッドの既定の実装では、対応する同期メソッドが呼び出され、完了した Task が返され、呼び出し元のスレッドがブロックされる可能性があります。 既定の実装では、既に取り消されたキャンセル トークンが渡された場合、取り消されたタスクも返されます。
非同期プログラミングをサポートするデータ プロバイダーは、非同期 I/O 操作を使用して既定の実装をオーバーライドする必要があります。
このメソッドは、早期に取り消す操作を要求するために使用できるキャンセル トークンを受け入れます。 実装では、この要求は無視される場合があります。
返された Task がまだ完了していない間は、DbDataReader オブジェクトの他のメソッドとプロパティを呼び出さないでください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 Read()によってスローされる例外を参照してください。