XmlNode.InsertBefore(XmlNode, XmlNode) 方法

定義

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

在指定的參考節點之前插入指定的節點。

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

參數

newChild
XmlNode

要插入的節點。

refChild
XmlNode

參考節點。 newChild 位於此節點之前。

傳回

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

備註

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

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

給繼承者的注意事項

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

適用於

另請參閱