SqlDataReader.ReadAsync(CancellationToken) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Read()の非同期バージョン。SqlDataReaderを次のレコードに進めます。
キャンセル トークンを使用して、コマンドのタイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返された Task オブジェクトを介して報告されます。
public:
override System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<bool> ReadAsync(System.Threading.CancellationToken cancellationToken);override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overrides Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)パラメーター
- cancellationToken
- CancellationToken
取り消し命令。
返品
非同期操作を表すタスク。
例外
タスクが完了する前に、同じインスタンスに対して ReadAsync(CancellationToken) を複数回呼び出します。
Context Connection=trueは、接続文字列で指定します。
SQL Serverコマンド テキストの実行中にエラーが返されました。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
ExecuteReaderAsyncのbehavior パラメーターが Default に設定されている場合、ReadAsyncは Task を返す前に行全体を読み取ります。
SQL Server用の .NET Framework Data Provider での非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 Read()によってスローされる例外を参照してください。