語言

XmlNode.AppendChild(XmlNode) 方法

定義

命名空間:
System.Xml
組件:
System.Xml.dll, System.Xml.XmlDocument.dll
組件:
netstandard.dll, System.Xml.ReaderWriter.dll
組件:
System.Xml.XmlDocument.dll
組件:
System.Xml.ReaderWriter.dll
組件:
System.Xml.dll
組件:
netstandard.dll
來源:
XmlNode.cs
來源:
XmlNode.cs
來源:
XmlNode.cs
來源:
XmlNode.cs
來源:
XmlNode.cs

將指定的節點加入該節點子節點清單的末尾。

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

要加的節點。 所有待加入節點的內容都會被移到指定位置。

傳回

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

輸出：

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 在樹中，則會從原始位置移除並加入目標位置。 欲了解更多關於插入節點的資訊，請參閱「插入節點」一節。

如果插入的節點是從其他文件建立的，你可以用 XmlDocument.ImportNode 來將該節點匯入到目前的文件。 匯入的節點接著可以插入到目前的文件中。

給繼承者的注意事項

在導出類別中覆 AppendChild 寫時，為了正確引發事件，必須呼叫 AppendChild 基底類別的方法。

適用於

另請參閱