SqlCommand.ExecuteXmlReader メソッド

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

SqlCommand.ExecuteXmlReader メソッド

CommandText を Connection に送信し、XmlReader オブジェクトを構築します。

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

Visual Basic (宣言)

Public Function ExecuteXmlReader As
 XmlReader

Visual Basic (使用法)

Dim instance As SqlCommand
Dim returnValue As XmlReader

returnValue = instance.ExecuteXmlReader

C#

public XmlReader ExecuteXmlReader ()

C++

public:
XmlReader^ ExecuteXmlReader ()

J#

public XmlReader ExecuteXmlReader ()

JScript

public function ExecuteXmlReader () : XmlReader

戻り値
XmlReader オブジェクト。

例外

例外の種類	条件
SqlException	ロックされている行に対してコマンドを実行しているときに例外が発生しました。この例外は .NET Framework Version 1.0 を使用している場合は生成されません。

解説

CommandText プロパティには、通常、有効な FOR XML 句を使用した Transact-SQL ステートメントを指定します。ただし、CommandText には、有効な XML を格納している ntext または nvarchar データを返すステートメントや、xml データ型で定義された列の内容も指定できます。

ExecuteXmlReader クエリは、通常、次の形式で指定します。この例は、Microsoft Visual C# のコード例です。

SqlCommand command = new SqlCommand("SELECT * FROM dbo.Customers FOR XML AUTO, XMLDATA",
 SqlConn);

メモ
このタイプのクエリは、Microsoft SQL Server 2000 以降でしか使用できません。詳細については、『SQL Server Books Online』の「FOR XML 句を使用するためのガイドライン」を参照してください。

SQL Server 2005 では、このメソッドを使用して、XML データを保持する、単一行、単一列の結果セットを取得することもできます。この場合、複数の行が返されると、ExecuteXmlReader メソッドが XmlReader を最初の行の値にアタッチし、結果セットの残りを破棄します。

SQL Server 2005 より前のバージョンの SQL Server の場合、XmlReader が使用されている間、関連付けられている SqlConnection は XmlReader によって使用されるため、ビジー状態になります。この状態では、SqlConnection に対して、閉じる以外の操作を実行できません。XmlReader の Close メソッドを呼び出すまでこの状態が続きます。SQL Server 2005 では、MARS (Multiple Active Result Set) 機能がサポートされ、同一接続を使用して複数の処理を実行できるようになりました。

ExecuteReader または BeginExecuteReader を使用して XML データにアクセスした場合、SQL Server は、長さが 2,033 文字を超える XML 結果を、各行が 2,033 文字から構成される複数の行に返します。この動作を回避するためには、ExecuteXmlReader または BeginExecuteXmlReader を使用して FOR XML クエリを読み取ります。詳細については、http://support.microsoft.com にある Microsoft サポート技術情報の文書 Q310378 (「PRB: XML Data Is Truncated When You Use SqlDataReader」) を参照してください。

使用例

SqlCommand を作成し、ExecuteXmlReader を使用して実行する例を次に示します。この例では、Transact-SQL FOR XML SELECT ステートメントの文字列とデータ ソースへの接続に使用する文字列が渡されます。

Visual Basic

Public Sub CreateXMLReader(ByVal
 queryString As String, _
    ByVal connectionString As String)

    Using connection As New SqlConnection(connectionString)
        connection.Open()

        Dim command As New
 SqlCommand(queryString, connection)
        Dim reader As System.Xml.XmlReader
 = command.ExecuteXmlReader
    End Using
End Sub

C#

private static void CreateXMLReader(string
 queryString,
    string connectionString)
{
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        connection.Open();
        SqlCommand command = new SqlCommand(queryString, connection);
        System.Xml.XmlReader reader = command.ExecuteXmlReader();
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

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