XmlNode.InsertBefore(XmlNode, XmlNode) Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlNode.cs

Közvetlenül a megadott referenciacsomópont elé szúrja be a megadott csomópontot.

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

Paraméterek

newChild

XmlNode

A beszúrni kívánt csomópont.

refChild

XmlNode

A referenciacsomópont. newChild a csomópont elé kerül.

Válaszok

XmlNode

A beszúrt csomópont.

Kivételek

InvalidOperationException

Az aktuális csomópont olyan típusú, amely nem engedélyezi a csomópont típusának gyermekcsomópontjait newChild .

A newChild csomópont őse.

ArgumentException

A newChild csomópontot létrehozó dokumentumtól eltérő dokumentumból lett létrehozva.

Ez refChild nem ennek a csomópontnak a gyermeke.

Ez a csomópont írásvédett.

Példák

Az alábbi példa egy új csomópontot ad hozzá az XML-dokumentumhoz.

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

Megjegyzések

Ha refChild igen null, szúrja be newChild a gyermekcsomópontok listájának végén. Az összes tartalom newChild ugyanabban a sorrendben lesz beszúrva.refChild Ha a newChild fa már szerepel a fán, akkor a rendszer eltávolítja az eredeti pozíciójából, és hozzáadja a célpozícióhoz. További információ a csomópontok beszúrásáról: Csomópontok beszúrása XML-dokumentumba.

Ha a beszúrt csomópont egy másik dokumentumból lett létrehozva, importálhatja XmlDocument.ImportNode a csomópontot az aktuális dokumentumba. Az importált csomópont ezután beilleszthető az aktuális dokumentumba.

Megjegyzések az öröklőkhöz

Származtatott osztály felülírásakor InsertBefore az események helyes előhívásához meg kell hívnia az InsertBefore alaposztály metódusát.

Lásd még

• ImportNode(XmlNode, Boolean)
• Csomópontok beszúrása XML-dokumentumba