XmlNode.AppendChild(XmlNode) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přidá zadaný uzel na konec seznamu podřízených uzlů tohoto uzlu.
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
Parametry
- newChild
- XmlNode
Uzel, který chcete přidat. Veškerý obsah uzlu, který se má přidat, se přesunou do zadaného umístění.
Návraty
Uzel byl přidán.
Výjimky
Tento uzel je typu, který neumožňuje podřízené uzly typu newChild
uzlu.
Toto newChild
je nadřazený uzel.
Byl newChild
vytvořen z jiného dokumentu než z dokumentu, který vytvořil tento uzel.
Tento uzel je jen pro čtení.
Příklady
Následující příklad přidá do dokumentu XML nový uzel.
#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 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 );
}
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
Výstup:
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>
Poznámky
newChild
Pokud je již ve stromu, odebere se z původní pozice a přidá se do cílové pozice. Další informace o vkládání uzlů najdete v tématu Vložení uzlů do dokumentu XML.
Pokud byl uzel vložen z jiného dokumentu, můžete ho importovat XmlDocument.ImportNode do aktuálního dokumentu. Importovaný uzel se pak dá vložit do aktuálního dokumentu.
Poznámky pro dědice
Při přepsání AppendChild
v odvozené třídě, aby události byly vyvolány správně, je nutné volat AppendChild
metodu základní třídy.