SqlCommand.ExecuteReaderAsync メソッド

定義

オーバーロード

ExecuteReaderAsync()

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

ExecuteReaderAsync(CommandBehavior)

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

ExecuteReaderAsync(CancellationToken)

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

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

ExecuteReaderAsync(CommandBehavior, CancellationToken)

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

ExecuteReaderAsync()

の非同期バージョンExecuteReader()。 に をCommandTextConnection送信し、 を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)

戻り値

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

例外

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

- または -

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

または

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

正しくない CommandBehavior 値。

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

- または -

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

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

- または -

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

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

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

注釈

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

注意

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

適用対象

ExecuteReaderAsync(CommandBehavior)

の非同期バージョン ExecuteReader(CommandBehavior) 。 に を CommandTextConnection 送信し、 を 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

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

戻り値

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

例外

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

- または -

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

または

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

正しくない CommandBehavior 値。

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

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

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

- または -

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

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

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

注釈

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

適用対象

ExecuteReaderAsync(CancellationToken)

の非同期バージョンExecuteReader()。 に をCommandTextConnection送信し、 を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

取り消し命令。

戻り値

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

例外

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

- または -

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

または

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

正しくない CommandBehavior 値。

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

- または -

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

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

- または -

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

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

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

注釈

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

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

cancellationToken
CancellationToken

取り消し命令。

戻り値

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

例外

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

- または -

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

または

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

正しくない CommandBehavior 値。

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

- または -

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

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

- または -

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

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

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

注釈

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

適用対象