XmlNode.PrependChild(XmlNode) 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlNode.cs

將指定節點加入該節點子節點清單的開頭。

public:
 virtual System::Xml::XmlNode ^ PrependChild(System::Xml::XmlNode ^ newChild);

public virtual System.Xml.XmlNode? PrependChild(System.Xml.XmlNode newChild);

abstract member PrependChild : System.Xml.XmlNode -> System.Xml.XmlNode
override this.PrependChild : System.Xml.XmlNode -> System.Xml.XmlNode

Public Overridable Function PrependChild (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.PrependChild(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.PrependChild(elem)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

備註

如果 已經 newChild 在樹中，則會從原始位置移除並加入目標位置。 欲了解更多關於插入節點的資訊，請參閱「插入節點」一節。

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

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

給繼承者的注意事項

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

另請參閱

• ImportNode(XmlNode, Boolean)
• 將節點插入 XML 檔