SqlDataReader.ReadAsync(CancellationToken) メソッド

定義

名前空間:

System.Data.SqlClient

アセンブリ:

System.Data.SqlClient.dll

パッケージ:

System.Data.SqlClient v4.8.6

次のレコードに Read() を進める SqlDataReader の非同期バージョン。

キャンセル トークンを使用すると、コマンド タイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返されたタスク オブジェクトによって報告されます。

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

取り消し命令。

戻り値

Task<Boolean>

非同期操作を表すタスク。

例外

InvalidOperationException

タスクの完了前に、同じインスタンスに対して ReadAsync(CancellationToken) を複数回呼び出しています。

Context Connection=true が接続文字列に指定されています。

SqlException

SQL Server がコマンド テキストの実行中にエラーを返しました。

OperationCanceledException

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

の パラメーターExecuteReaderAsyncが behavior に設定されている場合は、Task をDefaultReadAsync返す前に行全体を読み取ります。

.NET Framework Data Provider for SQL Serverでの非同期プログラミングに関するコード サンプルを含む詳細については、「非同期プログラミング」を参照してください。

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Read()スローされる例外に関するページを参照してください。

こちらもご覧ください

• ADO.NET の概要