SqlCommand.ExecuteReaderAsync メソッド

リファレンス

定義

名前空間:: Microsoft.Data.SqlClient

アセンブリ:: Microsoft.Data.SqlClient.dll

パッケージ:: Microsoft.Data.SqlClient v1.0.19269.1

パッケージ:: Microsoft.Data.SqlClient v1.1.4

パッケージ:: Microsoft.Data.SqlClient v2.0.1

パッケージ:: Microsoft.Data.SqlClient v2.1.4

パッケージ:: Microsoft.Data.SqlClient v3.0.1

パッケージ:: Microsoft.Data.SqlClient v3.1.0

パッケージ:: Microsoft.Data.SqlClient v4.0.1

パッケージ:: Microsoft.Data.SqlClient v4.1.0

パッケージ:: Microsoft.Data.SqlClient v5.0.0

パッケージ:: Microsoft.Data.SqlClient v5.1.0

パッケージ:: Microsoft.Data.SqlClient v5.2.0

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

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

ExecuteReaderAsync()

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

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

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

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

Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

戻り値

Task<SqlDataReader>

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

例外

InvalidCastException

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

- または -

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

または

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

ArgumentException

正しくない CommandBehavior 値。

InvalidOperationException

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

- または -

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

SqlException

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

- または -

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

IOException

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

ObjectDisposedException

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

注釈

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

注意

サーバーで実行時間の長いクエリの場合は、キャンセルトークンを使用したクエリの取り消しに関する既知の問題が原因でを使用 ExecuteReader することを検討してください。また、メソッドを使用して Cancel 実行を取り消すこともできます。

適用対象

ExecuteReaderAsync(CommandBehavior)

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

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

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

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

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

パラメーター

behavior: CommandBehavior

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

戻り値

Task<SqlDataReader>

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

例外

InvalidCastException

- または -

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

または

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

ArgumentException

正しくない CommandBehavior 値。

InvalidOperationException

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

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

SqlException

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

- または -

IOException

ObjectDisposedException

注釈

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

適用対象

ExecuteReaderAsync(CancellationToken)

の非同期バージョンExecuteReader()。にをCommandText Connection送信し、をSqlDataReaderビルドします。

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

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

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

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

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

パラメーター

cancellationToken: CancellationToken

取り消し命令。

戻り値

Task<SqlDataReader>

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

例外

InvalidCastException

- または -

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

または

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

ArgumentException

正しくない CommandBehavior 値。

InvalidOperationException

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

- または -

SqlException

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

- または -

IOException

ObjectDisposedException

注釈

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

適用対象

ExecuteReaderAsync(CommandBehavior, CancellationToken)

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

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

public System.Threading.Tasks.Task<Microsoft.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<Microsoft.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

- または -

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

または

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

ArgumentException

正しくない CommandBehavior 値。

InvalidOperationException

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

- または -

SqlException

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

- または -

IOException

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

ObjectDisposedException

注釈

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

適用対象

次の方法で共有

SqlCommand.ExecuteReaderAsync メソッド

定義

オーバーロード

ExecuteReaderAsync()

戻り値

例外

注釈

適用対象

ExecuteReaderAsync(CommandBehavior)

パラメーター

戻り値

例外

注釈

適用対象

ExecuteReaderAsync(CancellationToken)

パラメーター

戻り値

例外

注釈

適用対象

ExecuteReaderAsync(CommandBehavior, CancellationToken)

パラメーター

戻り値

例外

注釈

適用対象

その他のリソース