XmlDocument.ReadNode メソッド

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

XmlDocument.ReadNode メソッド

XmlReader 内の情報に基づいて、XmlNode オブジェクトを作成します。リーダーは、ノードまたは属性に配置されている必要があります。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 ReadNode ( _
    reader As XmlReader _
) As XmlNode

Visual Basic (使用法)

Dim instance As XmlDocument
Dim reader As XmlReader
Dim returnValue As XmlNode

returnValue = instance.ReadNode(reader)

C#

public virtual XmlNode ReadNode (
    XmlReader reader
)

C++

public:
virtual XmlNode^ ReadNode (
    XmlReader^ reader
)

J#

public XmlNode ReadNode (
    XmlReader reader
)

JScript

public function ReadNode (
    reader : XmlReader
) : XmlNode

パラメータ

reader

XML ソース。

戻り値
新しい XmlNode。ノードがそれ以上存在しない場合は null 参照 (Visual Basic では Nothing)。

例外

例外の種類	条件
InvalidOperationException	リーダーが、EndElement や EndEntity など、有効な DOM ノードに変換されないノード型に配置されています。

解説

指定したリーダーから 1 つの XmlNode を読み取り、そのリーダーを次のノードに配置します。このメソッドは、リーダーが現在配置されている NodeType に一致する XmlNode の型を作成します。リーダーが初期状態にある場合、ReadNode はリーダーを最初のノードに進めて、そのノード上で動作します。

リーダーが要素の先頭に配置されている場合、ReadNode は、現在のノードの終了タグを含め、その終了タグまでのすべての属性および子ノードを読み取ります。返された XmlNode には、読み取ったすべての内容を表すサブツリーが含まれます。リーダーは終了タグの直後に配置されます。

ReadNode も属性を読み取りますが、この場合は、リーダーを次の属性に進めません。これにより、次の C# コードを書き込むことができます。

 XmlDocument doc = new XmlDocument();
 while (reader.MoveToNextAttribute())
 {
   XmlNode a = doc.ReadNode(reader);
   // Do some more processing.
 }

ReadNode は属性値を使用しますが、1 つの属性で ReadNode を呼び出した後は、XmlReader.ReadAttributeValue は false を返します。

継承時の注意 このメソッドには継承確認要求があります。ReadNode メソッドをオーバーライドするには、完全な信頼が必要です。詳細については、「継承確認要求」を参照してください。 このメソッドは、DOM (Document Object Model) に対する Microsoft 拡張機能です。

使用例

ReadNode を使用して新しいノードを作成し、そのノードをドキュメントに挿入する例を次に示します。

Visual Basic

Option Explicit
Option Strict

Imports System
Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        'Create the XmlDocument.
        Dim doc As New XmlDocument()
        doc.LoadXml("<bookstore>" & _
                    "<book genre='novel' ISBN='1-861001-57-5'>"
 & _
                    "<title>Pride And Prejudice</title>"
 & _
                    "</book>" & _
                    "</bookstore>")
        
        'Create a reader.
        Dim reader As New
 XmlTextReader("cd.xml")
        reader.MoveToContent() 'Move to the cd element node.
        'Create a node representing the cd element node.
        Dim cd As XmlNode = doc.ReadNode(reader)
        
        'Insert the new node into the document.
        doc.DocumentElement.AppendChild(cd)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub 'Main 
End Class 'Sample

C#

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<bookstore>" +
                "<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>" +
                "</bookstore>");

    //Create a reader.
    XmlTextReader reader = new XmlTextReader("cd.xml");
    reader.MoveToContent(); //Move to the cd element node.

    //Create a node representing the cd element node.
    XmlNode cd = doc.ReadNode(reader);

    //Insert the new node into the document.
    doc.DocumentElement.AppendChild(cd); 
    
    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

C++

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   
   //Create the XmlDocument.
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<bookstore><book genre='novel' ISBN='1-861001-57-5'><title>Pride
 And Prejudice</title></book></bookstore>" );
   
   //Create a reader.
   XmlTextReader^ reader = gcnew XmlTextReader( "cd.xml" );
   reader->MoveToContent(); //Move to the cd element node.
   
   //Create a node representing the cd element node.
   XmlNode^ cd = doc->ReadNode( reader );
   
   //Insert the new node into the document.
   doc->DocumentElement->AppendChild( cd );
   Console::WriteLine( "Display the modified XML..." );
   doc->Save( Console::Out );
}

J#

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[]
 args)
    {
        //Create the XmlDocument.
        XmlDocument doc = new XmlDocument();
        doc.LoadXml("<bookstore>"
            + "<book genre='novel' ISBN='1-861001-57-5'>"
            + "<title>Pride And Prejudice</title>"
            + "</book>"
            + "</bookstore>");

        //Create a reader.
        XmlTextReader reader = new XmlTextReader("cd.xml");
        reader.MoveToContent(); //Move to the cd element node.

        //Create a node representing the cd element node.
        XmlNode cd = doc.ReadNode(reader);

        //Insert the new node into the document.
        doc.get_DocumentElement().AppendChild(cd);

        Console.WriteLine("Display the modified XML...");
        doc.Save(Console.get_Out());
    } //main 
} //Sample

この例では、入力として、cd.xml というファイルを使用しています。

<!-- sample CD -->
<cd genre='alternative'>
  <title>Americana</title>
  <artist>Offspring</artist>
</cd>

プラットフォーム

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

参照

関連項目
XmlDocument クラス
XmlDocument メンバ
System.Xml 名前空間
XmlReader
ImportNode