XmlNode.AppendChild(XmlNode) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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);
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
Het knooppunt is toegevoegd.
Uitzonderingen
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.
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.