SqlCommand.ExecuteReaderAsync SqlCommand.ExecuteReaderAsync SqlCommand.ExecuteReaderAsync SqlCommand.ExecuteReaderAsync Method

定義

この SqlCommand によって記述された Transact-SQLTransact-SQL ステートメントまたはストアド プロシージャの非同期実行を開始します。Initiates the asynchronous execution of the Transact-SQLTransact-SQL statement or stored procedure that is described by this SqlCommand.

オーバーロード

ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync()

CommandTextConnection を送信し SqlDataReader を構築する、ExecuteReader() の非同期バージョン。An asynchronous version of ExecuteReader(), which sends the CommandText to the Connection and builds a SqlDataReader. 例外は、返されたタスク オブジェクトによって報告されます。Exceptions will be reported via the returned Task object.

ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior)

CommandTextConnection を送信し SqlDataReader を構築する、ExecuteReader(CommandBehavior) の非同期バージョン。An asynchronous version of ExecuteReader(CommandBehavior), which sends the CommandText to the Connection, and builds a SqlDataReader. 例外は、返されたタスク オブジェクトによって報告されます。Exceptions will be reported via the returned Task object.

ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken)

CommandTextConnection を送信し SqlDataReader を構築する、ExecuteReader() の非同期バージョン。An asynchronous version of ExecuteReader(), which sends the CommandText to the Connection and builds a SqlDataReader.

キャンセル トークンを使用すると、コマンド タイムアウトが経過する前に操作を破棄するように要求できます。The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. 例外は、返されたタスク オブジェクトによって報告されます。Exceptions will be reported via the returned Task object.

ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken)

CommandTextConnection を送信し、SqlDataReader を構築する、ExecuteReader(CommandBehavior) の非同期バージョン。An asynchronous version of ExecuteReader(CommandBehavior), which sends the CommandText to the Connection, and builds a SqlDataReader

キャンセル トークンを使用すると、コマンド タイムアウトが経過する前に操作を破棄するように要求できます。The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. 例外は、返されたタスク オブジェクトによって報告されます。Exceptions will be reported via the returned Task object.

注釈

.NET Framework Data provider for SQL Server の非同期プログラミングの詳細については、次を参照してください。非同期プログラミングします。For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync()

CommandTextConnection を送信し SqlDataReader を構築する、ExecuteReader() の非同期バージョン。An asynchronous version of ExecuteReader(), which sends the CommandText to the Connection and builds a SqlDataReader. 例外は、返されたタスク オブジェクトによって報告されます。Exceptions will be reported via the returned Task object.

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)

戻り値

非同期操作を表すタスク。A task representing the asynchronous operation.

例外

ValueStream に設定されたときに、Binary でも VarBinary でもない SqlDbType が使用されました。A SqlDbType other than Binary or VarBinary was used when Value was set to Stream. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

または-or-

ValueTextReader に設定されたときに、CharNCharNVarCharVarCharXml のいずれでもない SqlDbType が使用されました。A SqlDbType other than Char, NChar, NVarChar, VarChar, or Xml was used when Value was set to TextReader.

- または --or-

ValueXmlReader に設定されたときに、Xml 以外の SqlDbType が使用されました。A SqlDbType other than Xml was used when Value was set to XmlReader.

タスクの完了前に、同じインスタンスに対して ExecuteReaderAsync() を複数回呼び出しています。Calling ExecuteReaderAsync() more than once for the same instance before task completion.

- または --or-

ストリーミング操作中に、SqlConnection が閉じられたか切断されました。The SqlConnection closed or dropped during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

- または --or-

Context Connection=true は接続文字列で指定されます。Context Connection=true is specified in the connection string.

SQL Server がコマンド テキストの実行中にエラーを返しました。SQL Server returned an error while executing the command text.

- または --or-

ストリーミング操作中にタイムアウトが発生しました。A timeout occurred during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

ストリーミング操作中に、StreamXmlReader、または TextReader オブジェクトでエラーが発生しました。An error occurred in a Stream, XmlReader or TextReader object during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

ストリーミング操作中に、StreamXmlReader、または TextReader オブジェクトが閉じられました。The Stream, XmlReader or TextReader object was closed during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

注釈

.NET Framework Data provider for SQL Server の非同期プログラミングの詳細については、次を参照してください。非同期プログラミングします。For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

こちらもご覧ください

ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior)

CommandTextConnection を送信し SqlDataReader を構築する、ExecuteReader(CommandBehavior) の非同期バージョン。An asynchronous version of ExecuteReader(CommandBehavior), which sends the CommandText to the Connection, and builds a SqlDataReader. 例外は、返されたタスク オブジェクトによって報告されます。Exceptions will be reported via the returned Task object.

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 CommandBehavior CommandBehavior CommandBehavior

ステートメントの実行とデータ取得に関するオプション。Options for statement execution and data retrieval. Default に設定されている場合、ReadAsync(CancellationToken) は完全なタスクを返す前に行全体を読み取ります。When is set to Default, ReadAsync(CancellationToken) reads the entire row before returning a complete Task.

戻り値

非同期操作を表すタスク。A task representing the asynchronous operation.

例外

ValueStream に設定されたときに、Binary でも VarBinary でもない SqlDbType が使用されました。A SqlDbType other than Binary or VarBinary was used when Value was set to Stream. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

- または --or-

ValueTextReader に設定されたときに、CharNCharNVarCharVarCharXml のいずれでもない SqlDbType が使用されました。A SqlDbType other than Char, NChar, NVarChar, VarChar, or Xml was used when Value was set to TextReader.

- または --or-

ValueXmlReader に設定されたときに、Xml 以外の SqlDbType が使用されました。A SqlDbType other than Xml was used when Value was set to XmlReader.

タスクの完了前に、同じインスタンスに対して ExecuteReaderAsync(CommandBehavior) を複数回呼び出しています。Calling ExecuteReaderAsync(CommandBehavior) more than once for the same instance before task completion.

- または --or-

ストリーミング操作中に、SqlConnection が閉じられたか切断されました。The SqlConnection closed or dropped during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

または-or-

Context Connection=true は接続文字列で指定されます。Context Connection=true is specified in the connection string.

SQL Server がコマンド テキストの実行中にエラーを返しました。SQL Server returned an error while executing the command text.

- または --or-

ストリーミング操作中にタイムアウトが発生しました。A timeout occurred during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

ストリーミング操作中に、StreamXmlReader、または TextReader オブジェクトでエラーが発生しました。An error occurred in a Stream, XmlReader or TextReader object during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

ストリーミング操作中に、StreamXmlReader、または TextReader オブジェクトが閉じられました。The Stream, XmlReader or TextReader object was closed during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

注釈

.NET Framework Data provider for SQL Server の非同期プログラミングの詳細については、次を参照してください。非同期プログラミングします。For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

こちらもご覧ください

ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken)

CommandTextConnection を送信し SqlDataReader を構築する、ExecuteReader() の非同期バージョン。An asynchronous version of ExecuteReader(), which sends the CommandText to the Connection and builds a SqlDataReader.

キャンセル トークンを使用すると、コマンド タイムアウトが経過する前に操作を破棄するように要求できます。The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. 例外は、返されたタスク オブジェクトによって報告されます。Exceptions will be reported via the returned Task object.

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>

パラメーター

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

取り消し命令。The cancellation instruction.

戻り値

非同期操作を表すタスク。A task representing the asynchronous operation.

例外

ValueStream に設定されたときに、Binary でも VarBinary でもない SqlDbType が使用されました。A SqlDbType other than Binary or VarBinary was used when Value was set to Stream. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

- または --or-

ValueTextReader に設定されたときに、CharNCharNVarCharVarCharXml のいずれでもない SqlDbType が使用されました。A SqlDbType other than Char, NChar, NVarChar, VarChar, or Xml was used when Value was set to TextReader.

- または --or- ValueXmlReader に設定されたときに、Xml 以外の SqlDbType が使用されました。A SqlDbType other than Xml was used when Value was set to XmlReader.

タスクの完了前に、同じインスタンスに対して ExecuteReaderAsync(CommandBehavior, CancellationToken) を複数回呼び出しています。Calling ExecuteReaderAsync(CommandBehavior, CancellationToken) more than once for the same instance before task completion.

- または --or-

ストリーミング操作中に、SqlConnection が閉じられたか切断されました。The SqlConnection closed or dropped during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

- または --or-

Context Connection=true は接続文字列で指定されます。Context Connection=true is specified in the connection string.

SQL Server がコマンド テキストの実行中にエラーを返しました。SQL Server returned an error while executing the command text.

または-or-

ストリーミング操作中にタイムアウトが発生しました。A timeout occurred during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

ストリーミング操作中に、StreamXmlReader、または TextReader オブジェクトでエラーが発生しました。An error occurred in a Stream, XmlReader or TextReader object during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

ストリーミング操作中に、StreamXmlReader、または TextReader オブジェクトが閉じられました。The Stream, XmlReader or TextReader object was closed during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

注釈

.NET Framework Data provider for SQL Server の非同期プログラミングの詳細については、次を参照してください。非同期プログラミングします。For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

こちらもご覧ください

ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken)

CommandTextConnection を送信し、SqlDataReader を構築する、ExecuteReader(CommandBehavior) の非同期バージョン。An asynchronous version of ExecuteReader(CommandBehavior), which sends the CommandText to the Connection, and builds a SqlDataReader

キャンセル トークンを使用すると、コマンド タイムアウトが経過する前に操作を破棄するように要求できます。The cancellation token can be used to request that the operation be abandoned before the command timeout elapses. 例外は、返されたタスク オブジェクトによって報告されます。Exceptions will be reported via the returned Task object.

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>

パラメーター

behavior
CommandBehavior CommandBehavior CommandBehavior CommandBehavior

ステートメントの実行とデータ取得に関するオプション。Options for statement execution and data retrieval. Defaultに設定されている場合、 ReadAsync(CancellationToken) は完全なタスクを返す前に行全体を読み取ります。When is set to Default, ReadAsync(CancellationToken) reads the entire row before returning a complete Task.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

取り消し命令。The cancellation instruction.

戻り値

非同期操作を表すタスク。A task representing the asynchronous operation.

例外

ValueStream に設定されたときに、Binary でも VarBinary でもない SqlDbType が使用されました。A SqlDbType other than Binary or VarBinary was used when Value was set to Stream. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

または-or-

ValueTextReader に設定されたときに、CharNCharNVarCharVarCharXml のいずれでもない SqlDbType が使用されました。A SqlDbType other than Char, NChar, NVarChar, VarChar, or Xml was used when Value was set to TextReader.

- または --or-

ValueXmlReader に設定されたときに、Xml 以外の SqlDbType が使用されました。A SqlDbType other than Xml was used when Value was set to XmlReader.

タスクの完了前に、同じインスタンスに対して ExecuteReaderAsync(CommandBehavior, CancellationToken) を複数回呼び出しています。Calling ExecuteReaderAsync(CommandBehavior, CancellationToken) more than once for the same instance before task completion.

または-or-

ストリーミング操作中に、SqlConnection が閉じられたか切断されました。The SqlConnection closed or dropped during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

- または --or-

Context Connection=true は接続文字列で指定されます。Context Connection=true is specified in the connection string.

SQL Server がコマンド テキストの実行中にエラーを返しました。SQL Server returned an error while executing the command text.

または-or-

ストリーミング操作中にタイムアウトが発生しました。A timeout occurred during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

ストリーミング操作中に、StreamXmlReader、または TextReader オブジェクトでエラーが発生しました。An error occurred in a Stream, XmlReader or TextReader object during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

ストリーミング操作中に、StreamXmlReader、または TextReader オブジェクトが閉じられました。The Stream, XmlReader or TextReader object was closed during a streaming operation. ストリーミングの詳細については、「SqlClient ストリーミング サポート」を参照してください。For more information about streaming, see SqlClient Streaming Support.

注釈

.NET Framework Data provider for SQL Server の非同期プログラミングの詳細については、次を参照してください。非同期プログラミングします。For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see Asynchronous Programming.

こちらもご覧ください

適用対象