XmlNode.InsertBefore(XmlNode, XmlNode) 方法

定义

命名空间:

System.Xml

程序集:

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

注解

null如果是refChild，请在子节点列表的末尾插入newChild。 之前按相同顺序refChild插入所有内容newChild。 newChild如果树中已存在，则会将其从其原始位置中删除，并将其添加到其目标位置。 有关插入节点的详细信息，请参阅 将节点插入 XML 文档。

如果要插入的节点是从另一个文档创建的，则可以使用该 XmlDocument.ImportNode 节点将节点导入到当前文档。 然后，可以将导入的节点插入到当前文档中。

继承者说明

在派生类中重写 InsertBefore 时，若要正确引发事件，必须调用 InsertBefore 基类的方法。

另请参阅

• ImportNode(XmlNode, Boolean)
• 将节点插入 XML 文档