SqlCommand.ExecuteReaderAsync メソッド

定義

名前空間:

System.Data.SqlClient

アセンブリ:

System.Data.SqlClient.dll

パッケージ:

System.Data.SqlClient v4.8.6

この SqlCommand によって定義された Transact-SQL ステートメントまたはストアド プロシージャの非同期実行を開始します。

オーバーロード

ExecuteReaderAsync()	CommandText に Connection を送信し SqlDataReader を構築する、ExecuteReader() の非同期バージョン。 例外は、返されたタスク オブジェクトによって報告されます。
ExecuteReaderAsync(CommandBehavior)	CommandText に Connection を送信し SqlDataReader を構築する、ExecuteReader(CommandBehavior) の非同期バージョン。 例外は、返されたタスク オブジェクトによって報告されます。
ExecuteReaderAsync(CancellationToken)	CommandText に Connection を送信し SqlDataReader を構築する、ExecuteReader() の非同期バージョン。 キャンセル トークンを使用すると、コマンド タイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返されたタスク オブジェクトによって報告されます。
ExecuteReaderAsync(CommandBehavior, CancellationToken)	CommandText に Connection を送信し、SqlDataReader を構築する、ExecuteReader(CommandBehavior) の非同期バージョン。 キャンセル トークンを使用すると、コマンド タイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返されたタスク オブジェクトによって報告されます。

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

ExecuteReaderAsync()

CommandText に Connection を送信し SqlDataReader を構築する、ExecuteReader() の非同期バージョン。 例外は、返されたタスク オブジェクトによって報告されます。

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync();

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync ();

override this.ExecuteReaderAsync : unit -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

戻り値

Task<SqlDataReader>

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

例外

InvalidCastException

Value が Stream に設定されたときに、Binary でも VarBinary でもない SqlDbType が使用されました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

- または -

SqlDbTypeが にTextReader設定されている場合Value、Char、NChar、NVarChar、VarChar、または Xml 以外の が使用されました。

- または -

Value が XmlReader に設定されたときに、Xml 以外の SqlDbType が使用されました。

ArgumentException

正しくない CommandBehavior 値。

InvalidOperationException

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

- または -

ストリーミング操作中に、SqlConnection が閉じられたか切断されました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

- または -

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

SqlException

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

- または -

ストリーミング操作中にタイムアウトが発生しました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

IOException

ストリーミング操作中に、Stream、XmlReader、または TextReader オブジェクトでエラーが発生しました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

ObjectDisposedException

ストリーミング操作中に、Stream、XmlReader、または TextReader オブジェクトが閉じられました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

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

こちらもご覧ください

• ADO.NET の概要

ExecuteReaderAsync(CommandBehavior)

CommandText に Connection を送信し SqlDataReader を構築する、ExecuteReader(CommandBehavior) の非同期バージョン。 例外は、返されたタスク オブジェクトによって報告されます。

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync (System.Data.CommandBehavior behavior);

override this.ExecuteReaderAsync : System.Data.CommandBehavior -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (behavior As CommandBehavior) As Task(Of SqlDataReader)

パラメーター

behavior

CommandBehavior

ステートメントの実行とデータ取得に関するオプション。 Default に設定されている場合、ReadAsync(CancellationToken) は完全なタスクを返す前に行全体を読み取ります。

戻り値

Task<SqlDataReader>

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

例外

InvalidCastException

Value が Stream に設定されたときに、Binary でも VarBinary でもない SqlDbType が使用されました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

- または -

SqlDbTypeが にTextReader設定されている場合Value、Char、NChar、NVarChar、VarChar、または Xml 以外の が使用されました。

- または -

Value が XmlReader に設定されたときに、Xml 以外の SqlDbType が使用されました。

ArgumentException

正しくない CommandBehavior 値。

InvalidOperationException

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

- または -

ストリーミング操作中に、SqlConnection が閉じられたか切断されました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

- または -

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

SqlException

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

- または -

ストリーミング操作中にタイムアウトが発生しました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

IOException

ストリーミング操作中に、Stream、XmlReader、または TextReader オブジェクトでエラーが発生しました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

ObjectDisposedException

ストリーミング操作中に、Stream、XmlReader、または TextReader オブジェクトが閉じられました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

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

こちらもご覧ください

• ADO.NET の概要

ExecuteReaderAsync(CancellationToken)

CommandText に Connection を送信し SqlDataReader を構築する、ExecuteReader() の非同期バージョン。

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

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync (System.Threading.CancellationToken cancellationToken);

override this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (cancellationToken As CancellationToken) As Task(Of SqlDataReader)

パラメーター

cancellationToken

CancellationToken

取り消し命令。

戻り値

Task<SqlDataReader>

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

例外

InvalidCastException

Value が Stream に設定されたときに、Binary でも VarBinary でもない SqlDbType が使用されました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

- または -

SqlDbTypeが にTextReader設定されている場合Value、Char、NChar、NVarChar、VarChar、または Xml 以外の が使用されました。

- または -

Value が XmlReader に設定されたときに、Xml 以外の SqlDbType が使用されました。

ArgumentException

正しくない CommandBehavior 値。

InvalidOperationException

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

- または -

ストリーミング操作中に、SqlConnection が閉じられたか切断されました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

- または -

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

SqlException

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

- または -

ストリーミング操作中にタイムアウトが発生しました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

IOException

ストリーミング操作中に、Stream、XmlReader、または TextReader オブジェクトでエラーが発生しました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

ObjectDisposedException

ストリーミング操作中に、Stream、XmlReader、または TextReader オブジェクトが閉じられました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

OperationCanceledException

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

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

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

こちらもご覧ください

• ADO.NET の概要

ExecuteReaderAsync(CommandBehavior, CancellationToken)

CommandText に Connection を送信し、SqlDataReader を構築する、ExecuteReader(CommandBehavior) の非同期バージョン。

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

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync (System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);

override this.ExecuteReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of SqlDataReader)

パラメーター

behavior

CommandBehavior

ステートメントの実行とデータ取得に関するオプション。 Default に設定されている場合、ReadAsync(CancellationToken) は完全なタスクを返す前に行全体を読み取ります。

cancellationToken

CancellationToken

取り消し命令。

戻り値

Task<SqlDataReader>

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

例外

InvalidCastException

Value が Stream に設定されたときに、Binary でも VarBinary でもない SqlDbType が使用されました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

- または -

SqlDbTypeが にTextReader設定されている場合Value、Char、NChar、NVarChar、VarChar、または Xml 以外の が使用されました。

- または -

Value が XmlReader に設定されたときに、Xml 以外の SqlDbType が使用されました。

ArgumentException

正しくない CommandBehavior 値。

InvalidOperationException

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

- または -

ストリーミング操作中に、SqlConnection が閉じられたか切断されました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

- または -

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

SqlException

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

- または -

ストリーミング操作中にタイムアウトが発生しました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

IOException

ストリーミング操作中に、Stream、XmlReader、または TextReader オブジェクトでエラーが発生しました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

ObjectDisposedException

ストリーミング操作中に、Stream、XmlReader、または TextReader オブジェクトが閉じられました。 ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。

OperationCanceledException

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

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

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

こちらもご覧ください

• ADO.NET の概要