XmlDocument.ReadNode(XmlReader) Método

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

Parâmetros

Devoluções

Os novos XmlNode ou null se não existirem mais nós.

Exceções

Exemplos

O exemplo seguinte serve ReadNode para criar um novo nó e depois insere o novo nó no documento.

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

O exemplo usa o ficheiro , cd.xmlcomo entrada.

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

Observações

Lê um XmlNode do leitor dado e posiciona o leitor no nó seguinte. Este método cria o tipo de XmlNode correspondência sobre a NodeType qual o leitor está atualmente posicionado. (Se o leitor estiver no estado inicial, ReadNode avança o leitor para o primeiro nó e depois opera nesse nó.)

Se o leitor estiver posicionado no início de um elemento, ReadNode lê todos os atributos e quaisquer nós filhos, até e incluindo a etiqueta final do nó atual. O XmlNode retorno contém a subárvore que representa tudo o que é lido. O leitor posiciona-se imediatamente após a etiqueta final.

ReadNode também pode ler atributos, mas neste caso não avança o leitor para o atributo seguinte. Isto permite-lhe escrever o seguinte código C#:

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

ReadNode consome o valor do atributo, o que significa que, após chamar ReadNode um atributo, devolve XmlReader.ReadAttributeValuefalse.

Notas para Herdeiros

Este método tem uma exigência de herança. É necessária total confiança para sobrepor o ReadNode método.

Este método é uma extensão da Microsoft para o Document Object Model (DOM).

Ver também

• XmlReader
• ImportNode(XmlNode, Boolean)