XmlNode.AppendChild(XmlNode) 方法

定义

将指定的节点添加到此节点的子节点列表的末尾。

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

参数

newChild
XmlNode

要添加的节点。 要添加的节点的所有内容将移动到指定位置。

返回

添加的节点。

例外

此节点的类型不允许节点类型的 newChild 子节点。

newChild 节点的上级。

创建的 newChild 文档不同于创建此节点的文档。

此节点是只读的。

示例

以下示例将新节点添加到 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>

注解

newChild如果树中已存在,则会将其从其原始位置中删除,并将其添加到其目标位置。 有关插入节点的详细信息,请参阅 将节点插入 XML 文档

如果要插入的节点是从另一个文档创建的,则可以使用该 XmlDocument.ImportNode 节点将节点导入到当前文档。 然后,可以将导入的节点插入到当前文档中。

继承者说明

在派生类中重写 AppendChild 时,若要正确引发事件,必须调用 AppendChild 基类的方法。

适用于

另请参阅