XmlNode.InsertAfter(XmlNode, XmlNode) Methode

Definition

Namespace:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.XmlDocument.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Fügt den angegebenen Knoten unmittelbar nach dem angegebenen Verweisknoten ein.

public:
 virtual System::Xml::XmlNode ^ InsertAfter(System::Xml::XmlNode ^ newChild, System::Xml::XmlNode ^ refChild);
public virtual System.Xml.XmlNode InsertAfter(System.Xml.XmlNode newChild, System.Xml.XmlNode refChild);
abstract member InsertAfter : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode
override this.InsertAfter : System.Xml.XmlNode * System.Xml.XmlNode -> System.Xml.XmlNode
Public Overridable Function InsertAfter (newChild As XmlNode, refChild As XmlNode) As XmlNode

Parameter

newChild
XmlNode

Der einzufügende Knoten.

refChild
XmlNode

Der Verweisknoten. newChild wird nach refChild.

Gibt zurück

XmlNode

Der eingefügte Knoten.

Ausnahmen

InvalidOperationException

Dieser Knoten weist einen Typ auf, der untergeordnete Knoten des Knotentyps newChild nicht zulässt.

Dies newChild ist ein Vorgänger dieses Knotens.

ArgumentException

Die newChild Datei wurde aus einem anderen Dokument als dem Dokument erstellt, das diesen Knoten erstellt hat.

Dies refChild ist kein untergeordnetes Element dieses Knotens.

Dieser Knoten ist schreibgeschützt.

Beispiele

Im folgenden Beispiel wird dem XML-Dokument ein neuer Knoten hinzugefügt.

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.InsertAfter(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.InsertAfter(elem, root.FirstChild)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

Hinweise

Wenn refChild ja null, fügen Sie newChild am Anfang der Liste der untergeordneten Knoten ein. Alle Inhalte des Inhalts newChild werden in derselben Reihenfolge eingefügt, nach refChild. Wenn sich die newChild Struktur bereits befindet, wird sie von der ursprünglichen Position entfernt und der Zielposition hinzugefügt. Weitere Informationen zum Einfügen von Knoten finden Sie unter Einfügen von Knoten in ein XML-Dokument.

Wenn der eingefügte Knoten aus einem anderen Dokument erstellt wurde, können XmlDocument.ImportNode Sie den Knoten in das aktuelle Dokument importieren. Der importierte Knoten kann dann in das aktuelle Dokument eingefügt werden.

Diese Methode ist eine Microsoft Erweiterung für das Document Object Model (DOM).

Hinweise für Vererber

Beim Überschreiben InsertAfter in einer abgeleiteten Klasse müssen Sie die InsertAfter Methode der Basisklasse aufrufen, damit Ereignisse ordnungsgemäß ausgelöst werden.

Gilt für:

Weitere Informationen