XmlNode.AppendChild(XmlNode) Methode

Definitie

Naamruimte:

System.Xml

Assembly's:

netstandard.dll, System.Xml.ReaderWriter.dll

Bron:

XmlNode.cs

Hiermee voegt u het opgegeven knooppunt toe aan het einde van de lijst met onderliggende knooppunten van dit knooppunt.

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

Parameters

newChild

XmlNode

Het knooppunt dat moet worden toegevoegd. Alle inhoud van het knooppunt dat moet worden toegevoegd, wordt verplaatst naar de opgegeven locatie.

Retouren

XmlNode

Het knooppunt is toegevoegd.

Uitzonderingen

InvalidOperationException

Dit knooppunt is van een type dat geen onderliggende knooppunten van het type newChild knooppunt toestaat.

Het newChild is een bovenliggend element van dit knooppunt.

ArgumentException

De newChild is gemaakt op basis van een ander document dan het document dat dit knooppunt heeft gemaakt.

Dit knooppunt heeft het kenmerk Alleen-lezen.

Voorbeelden

In het volgende voorbeeld wordt een nieuw knooppunt toegevoegd aan het XML-document.

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>

Opmerkingen

Als de newChild structuur zich al in de structuur bevindt, wordt deze verwijderd van de oorspronkelijke positie en toegevoegd aan de doelpositie. Zie Knooppunten invoegen in een XML-document voor meer informatie over het invoegen van knooppunten.

Als het knooppunt dat wordt ingevoegd, is gemaakt vanuit een ander document, kunt XmlDocument.ImportNode u het knooppunt importeren in het huidige document. Het geïmporteerde knooppunt kan vervolgens worden ingevoegd in het huidige document.

Notities voor overnemers

Wanneer u AppendChild overschrijft in een afgeleide klasse, moet u de AppendChild methode van de basisklasse aanroepen om gebeurtenissen correct te kunnen genereren.

Zie ook

• ImportNode(XmlNode, Boolean)
• Knooppunten invoegen in een XML-document