Adds the specified node to the end of the list of child nodes, of this node.
(in System.Xml.dll)
Visual Basic (Declaration)
Public Overridable Function AppendChild ( _
newChild As XmlNode _
) As XmlNode
Dim instance As XmlNode
Dim newChild As XmlNode
Dim returnValue As XmlNode
returnValue = instance.AppendChild(newChild)
public virtual XmlNode AppendChild(
XmlNode newChild
)
public:
virtual XmlNode^ AppendChild(
XmlNode^ newChild
)
public function AppendChild(
newChild : XmlNode
) : XmlNode
Parameters
- newChild
- Type: System.Xml..::.XmlNode
The node to add. All the contents of the node to be added are moved into the specified location.
| Exception | Condition |
|---|
| InvalidOperationException | This node is of a type that does not allow child nodes of the type of the newChild node. The newChild is an ancestor of this node. |
| ArgumentException | The newChild was created from a different document than the one that created this node. This node is read-only. |
If the newChild is already in the tree, it is removed from its original position and added to its target position. For more information about inserting nodes, see Inserting Nodes into an XML Document.
If the node being inserted was created from another document, you can use XmlDocument..::.ImportNode to import the node to the current document. The imported node can then be inserted into the current document.
Notes to Inheritors: When overriding AppendChild in a derived class, in order for events to be raised correctly, you must call the AppendChild method of the base class.
The following example adds a new node to the XML document.
Option Explicit
Option Strict
Imports System
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 'Main
End Class 'Sample
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);
}
}
#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 <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main() {
XmlDocument* doc = new XmlDocument();
doc->LoadXml(S"<book genre='novel' ISBN='1-861001-57-5'>"
S"<title>Pride And Prejudice</title>"
S"</book>");
XmlNode* root = doc->DocumentElement;
//Create a new node.
XmlElement* elem = doc->CreateElement(S"price");
elem->InnerText=S"19.95";
//Add the node to the document.
root->AppendChild(elem);
Console::WriteLine(S"Display the modified XML...");
doc->Save(Console::Out);
}
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
.NET Framework
Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
.NET Compact Framework
Supported in: 3.5, 2.0, 1.0
XNA Framework
Supported in: 3.0, 2.0, 1.0
Reference
Other Resources