XmlNode.AppendChild(XmlNode) Método

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.dll

Agrega el nodo especificado al final de la lista de nodos secundarios de este nodo.

public:
 virtual System::Xml::XmlNode ^ AppendChild(System::Xml::XmlNode ^ newChild);

public virtual System.Xml.XmlNode AppendChild(System.Xml.XmlNode newChild);

abstract member AppendChild : System.Xml.XmlNode -> System.Xml.XmlNode
override this.AppendChild : System.Xml.XmlNode -> System.Xml.XmlNode

Public Overridable Function AppendChild (newChild As XmlNode) As XmlNode

Parámetros

newChild

XmlNode

Nodo que se va a agregar. Todo el contenido del nodo que se va a agregar se mueve a la ubicación especificada.

Devoluciones

XmlNode

Nodo agregado.

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.

Ejemplos

En el ejemplo siguiente se agrega un nuevo nodo al 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 node.
    XmlElement elem = doc.CreateElement("price");
    elem.InnerText="19.95";

    //Add the node to the document.
    root.AppendChild(elem);

    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()
        
        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 node.
        Dim elem As XmlElement = doc.CreateElement("price")
        elem.InnerText = "19.95"
        
        'Add the node to the document.
        root.AppendChild(elem)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

Output:

Display the modified XML...
<?xml version="1.0" encoding="IBM437"?>
<book genre="novel" ISBN="1-861001-57-5">
  <title>Pride And Prejudice</title>
  <price>19.95</price>

Comentarios

Si el newChild objeto ya está en el árbol, se quita de su posición original y se agrega a su posición de destino. Para obtener más información sobre cómo insertar nodos, vea Insertar nodos en un documento XML.

Si el nodo que se va a insertar 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 insertar en el documento actual.

Notas a los desarrolladores de herederos

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

Consulte también

• ImportNode(XmlNode, Boolean)
• Insertar nodos en un documento XML