XmlNode.AppendChild(XmlNode) 方法

定义

命名空间:

System.Xml

程序集:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlNode.cs

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

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

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

返回

XmlNode

添加的节点。

例外

InvalidOperationException

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

此 newChild 节点的上级。

ArgumentException

创建的 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 基类的方法。

另请参阅

• ImportNode(XmlNode, Boolean)
• 将节点插入 XML 文档