XmlNode.ReplaceChild(XmlNode, XmlNode) Método

Definición

Espacio de nombres:
System.Xml
Ensamblados:
System.Xml.dll, System.Xml.XmlDocument.dll
Ensamblado:
System.Xml.dll
Ensamblado:
netstandard.dll

Reemplaza el nodo oldChild secundario por newChild el nodo .

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

Nuevo nodo que se va a colocar en la lista secundaria.

oldChild
XmlNode

Nodo que se va a reemplazar en la lista.

Devoluciones

XmlNode

Nodo reemplazado.

Excepciones

InvalidOperationException

Este nodo es de un tipo que no permite nodos secundarios del tipo del newChild nodo.

newChild es un antecesor de este nodo.

ArgumentException

newChild se creó a partir de un documento diferente al que creó este nodo.

Este nodo es de solo lectura.

no oldChild es un elemento secundario de este nodo.

Ejemplos

En el ejemplo siguiente se reemplaza el elemento title del documento XML.

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

Comentarios

Si el newChild elemento ya está en el árbol, primero se quita.

newChild Si se creó a partir de otro documento, puede usar XmlDocument.ImportNode para importar el nodo al documento actual. A continuación, el nodo importado se puede pasar al ReplaceChild método .

Notas a los desarrolladores de herederos

Al invalidar ReplaceChild en una clase derivada, para que los eventos se generen correctamente, debe llamar al ReplaceChild método de la clase base.

Se aplica a

Consulte también