XmlNode.PrependChild(XmlNode) 方法

定義

命名空間:

System.Xml

組件:

System.Xml.dll, System.Xml.XmlDocument.dll

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.XmlDocument.dll

組件:

System.Xml.dll

組件:

netstandard.dll

將指定的節點加入這個節點之子節點清單的開頭。

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

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.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew 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 );
}

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如果 已在樹狀結構中，則會從其原始位置中移除，並新增至其目標位置。 如需插入節點的詳細資訊，請參閱 將節點插入 XML 檔。

如果插入的節點是從另一份檔建立的，您可以使用 XmlDocument.ImportNode 將節點匯入至目前的檔。 匯入的節點接著可以插入至目前的檔。

此方法是檔物件模型 (DOM) 的 Microsoft 延伸模組。

給繼承者的注意事項

在衍生類別中覆寫 PrependChild 時，若要正確引發事件，您必須呼叫 PrependChild 基類的 方法。

另請參閱

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