XmlDocument.ReadNode(XmlReader) メソッド

定義

名前空間:

System.Xml

アセンブリ:

netstandard.dll, System.Xml.ReaderWriter.dll

ソース:

XmlDocument.cs

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

public:
 virtual System::Xml::XmlNode ^ ReadNode(System::Xml::XmlReader ^ reader);

public virtual System.Xml.XmlNode? ReadNode(System.Xml.XmlReader reader);

abstract member ReadNode : System.Xml.XmlReader -> System.Xml.XmlNode
override this.ReadNode : System.Xml.XmlReader -> System.Xml.XmlNode

Public Overridable Function ReadNode (reader As XmlReader) As XmlNode

パラメーター

reader

XmlReader

XML ソース。

戻り値

XmlNode

ノードが存在しない場合は、新しい XmlNode または null 。

例外

NullReferenceException

リーダーは、有効な DOM ノード (EndElement や EndEntity など) に変換されないノード の種類に配置されます。

例

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

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);
  }
}

Option Explicit
Option Strict

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
End Class

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

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

注釈

特定のリーダーから 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 は属性値を使用します。つまり、属性で ReadNode を呼び出した後、 XmlReader.ReadAttributeValue は falseを返します。

注意 (継承者)

このメソッドには継承要求があります。 ReadNode メソッドをオーバーライドするには、完全信頼が必要です。

このメソッドは、ドキュメント オブジェクト モデル (DOM) に対する Microsoft の拡張機能です。

こちらもご覧ください

• XmlReader
• ImportNode(XmlNode, Boolean)