SqlCommand.EndExecuteReader メソッド

.NET Framework クラス ライブラリ リファレンス

SqlCommand.EndExecuteReader メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

Transact-SQL ステートメントの非同期実行を完了し、要求された SqlDataReader を返します。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Function EndExecuteReader ( _
    asyncResult As IAsyncResult _
) As SqlDataReader

Visual Basic (使用法)

Dim instance As SqlCommand
Dim asyncResult As IAsyncResult
Dim returnValue As SqlDataReader

returnValue = instance.EndExecuteReader(asyncResult)

C#

public SqlDataReader EndExecuteReader (
    IAsyncResult asyncResult
)

C++

public:
SqlDataReader^ EndExecuteReader (
    IAsyncResult^ asyncResult
)

J#

public SqlDataReader EndExecuteReader (
    IAsyncResult asyncResult
)

JScript

public function EndExecuteReader (
    asyncResult : IAsyncResult
) : SqlDataReader

パラメータ

asyncResult

BeginExecuteReader の呼び出しで返される IAsyncResult。

戻り値
要求された行を取得するための SqlDataReader オブジェクト。

例外

例外の種類	条件
ArgumentException	asyncResult パラメータが null (Microsoft Visual Basic の場合は Nothing) です。
InvalidOperationException	単一のコマンド実行に対して EndExecuteReader が複数回呼び出されたか、実行メソッドに対して不適切なメソッドが呼び出されました (たとえば、BeginExecuteXmlReader の呼び出しの実行を完了するために、コードで EndExecuteReader を呼び出した場合)。

解説

BeginExecuteReader を呼び出して Transact-SQL ステートメントを実行する場合は、EndExecuteReader を呼び出して、操作を完了させる必要があります。コマンドの実行プロセスが完了していない場合、このメソッドは操作の完了までブロック状態になります。コマンドの操作が完了しているかどうかは、BeginExecuteReader メソッドによって返された IAsyncResult のインスタンスを使用して確認できます。BeginExecuteReader の呼び出しでコールバック プロシージャを指定した場合、このメソッドを呼び出す必要があります。

使用例

EndExecuteReader メソッドの実際の使用例については、「BeginExecuteReader」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SqlCommand クラス
SqlCommand メンバ
System.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータへの接続およびデータの取得
.NET Framework Data Provider for SQL Server の使用