XmlNode.InsertAfter(XmlNode, XmlNode) 方法

定義

命名空間:
System.Xml
組件:
System.Xml.dll, System.Xml.XmlDocument.dll
組件:
System.Xml.dll
組件:
netstandard.dll

在指定的參考節點之後立即插入指定的節點。

public:
 virtual System::Xml::XmlNode ^ InsertAfter(System::Xml::XmlNode ^ newChild, System::Xml::XmlNode ^ refChild);
public virtual System.Xml.XmlNode InsertAfter(System.Xml.XmlNode newChild, System.Xml.XmlNode refChild);
abstract member InsertAfter : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode
override this.InsertAfter : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode
Public Overridable Function InsertAfter (newChild As XmlNode, refChild As XmlNode) As XmlNode

參數

newChild
XmlNode

要插入的節點。

refChild
XmlNode

參考節點。 newChild 位於 refChild之後。

傳回

XmlNode

節點正在入。

例外狀況

InvalidOperationException

此節點的類型不允許該節點 newChild 的子節點存在。

是 newChild 這個節點的祖先。

ArgumentException

這個 newChild 節點是從另一個文件建立的，而不是建立這個節點的那個。

這 refChild 不是這個節點的子節點。

此節點為唯讀。

範例

以下範例為 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.InsertAfter(elem, root.FirstChild);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);
  }
}

Option Strict
Option Explicit

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.InsertAfter(elem, root.FirstChild)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

備註

若 refChild 是 null，則插入 newChild 子節點列表的開頭。 所有 的內容 newChild 會依相同順序插入於 refChild之後。 如果 已經 newChild 在樹中，則會從原始位置移除並加入目標位置。 欲了解更多關於插入節點的資訊，請參閱「插入節點」一節。

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

此方法是 Microsoft 對文件物件模型（DOM）的擴充。

給繼承者的注意事項

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

適用於

另請參閱