XmlNode.InsertAfter(XmlNode, XmlNode) Methode

Referenz

Definition

Namespace:: System.Xml

Assemblys:: System.Xml.dll, System.Xml.XmlDocument.dll

Assemblys:: netstandard.dll, System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XmlDocument.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Quelle:: XmlNode.cs

Quelle:: XmlNode.cs

Quelle:: XmlNode.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Fügt den angegebenen Knoten unmittelbar hinter 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);

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 hinter refChild platziert.

Gibt zurück

XmlNode

Der Knoten, der eingefügt wird.

Ausnahmen

InvalidOperationException

Der Typ dieses Knotens lässt keine untergeordneten Knoten vom Typ des newChild-Knotens zu.

newChild ist eine frühere Version dieses Knotens.

ArgumentException

newChild wurde nicht aus dem Dokument erstellt, aus dem dieser Knoten erstellt wurde.

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.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->InsertAfter( elem, root->FirstChild );
   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.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 ist null, fügen Sie am Anfang der Liste der untergeordneten Knoten ein newChild . Alle Inhalte von newChild werden in der gleichen Reihenfolge nach refChildeingefügt. Wenn sich der newChild bereits in der Struktur befindet, wird es von seiner ursprünglichen Position entfernt und seiner 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 des Document Object Model (DOM).

Hinweise für Vererber

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

Gilt für:

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1
UWP	10.0

Freigeben über