XmlNode.ReplaceChild(XmlNode, XmlNode) Método

  • Referência

Definição

Namespace:
System.Xml
Assemblies:
System.Xml.dll, System.Xml.XmlDocument.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XmlDocument.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Substitui o nó filho oldChild pelo nó newChild.

public:
 virtual System::Xml::XmlNode ^ ReplaceChild(System::Xml::XmlNode ^ newChild, System::Xml::XmlNode ^ oldChild);
public virtual System.Xml.XmlNode ReplaceChild (System.Xml.XmlNode newChild, System.Xml.XmlNode oldChild);
abstract member ReplaceChild : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode
override this.ReplaceChild : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode
Public Overridable Function ReplaceChild (newChild As XmlNode, oldChild As XmlNode) As XmlNode

Parâmetros

newChild
XmlNode

O novo nó a ser colocado na lista de filhos.

oldChild
XmlNode

O nó que está sendo substituído na lista.

Retornos

XmlNode

O nó substituído.

Exceções

InvalidOperationException

Esse nó é de um tipo que não permite nós filho do tipo do nó newChild.

O newChild é um ancestral desse nó.

ArgumentException

O newChild foi criado com base em um documento diferente daquele que criou esse nó.

Este nó é somente leitura.

O oldChild não é filho desse nó.

Exemplos

O exemplo a seguir substitui o elemento de título no documento XML.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book genre='novel' ISBN='1-861001-57-5'>"
   "<title>Pride And Prejudice</title>"
   "</book>" );
   XmlNode^ root = doc->DocumentElement;
   
   //Create a new title element.
   XmlElement^ elem = doc->CreateElement( "title" );
   elem->InnerText = "The Handmaid's Tale";
   
   //Replace the title element.
   root->ReplaceChild( elem, root->FirstChild );
   Console::WriteLine( "Display the modified XML..." );
   doc->Save( Console::Out );
}

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

public class Sample {

  public static void Main() {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //Create a new title element.
    XmlElement elem = doc.CreateElement("title");
    elem.InnerText="The Handmaid's Tale";

    //Replace the title element.
    root.ReplaceChild(elem, root.FirstChild);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);
  }
}

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        
        Dim doc As New XmlDocument()
        doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" & _
                    "<title>Pride And Prejudice</title>" & _
                    "</book>")
        
        Dim root As XmlNode = doc.DocumentElement
        
        'Create a new title element.
        Dim elem As XmlElement = doc.CreateElement("title")
        elem.InnerText = "The Handmaid's Tale"
        
        'Replace the title element.
        root.ReplaceChild(elem, root.FirstChild)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

Comentários

Se o newChild já estiver na árvore, ele será removido primeiro.

Se o newChild documento tiver sido criado a partir de outro documento, você poderá usar XmlDocument.ImportNode para importar o nó para o documento atual. O nó importado pode então ser passado para o ReplaceChild método.

Notas aos Herdeiros

Ao substituir ReplaceChild em uma classe derivada, para que os eventos sejam gerados corretamente, você deve chamar o ReplaceChild método da classe base.

Aplica-se a

Confira também