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 文档中