次の方法で共有


SqlDataReader.ReadAsync(CancellationToken) メソッド

定義

次のレコードに 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

取り消し命令。

戻り値

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

例外

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

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

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

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

注釈

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

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

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

適用対象

こちらもご覧ください