SqlCommand.EndExecuteXmlReader メソッド

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

SqlCommand.EndExecuteXmlReader メソッド

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

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

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

Visual Basic (宣言)

Public Function EndExecuteXmlReader ( _
    asyncResult As IAsyncResult _
) As XmlReader

Visual Basic (使用法)

Dim instance As SqlCommand
Dim asyncResult As IAsyncResult
Dim returnValue As XmlReader

returnValue = instance.EndExecuteXmlReader(asyncResult)

C#

public XmlReader EndExecuteXmlReader (
    IAsyncResult asyncResult
)

C++

public:
XmlReader^ EndExecuteXmlReader (
    IAsyncResult^ asyncResult
)

J#

public XmlReader EndExecuteXmlReader (
    IAsyncResult asyncResult
)

JScript

public function EndExecuteXmlReader (
    asyncResult : IAsyncResult
) : XmlReader

パラメータ

asyncResult

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

戻り値
結果の XML データをフェッチするときに使用する XmlReader オブジェクト。

例外

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

解説

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

使用例

EndExecuteXmlReader メソッドの実際の使用例については、「BeginExecuteXmlReader」および「BeginExecuteXmlReader」を参照してください。

プラットフォーム

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 の使用