XmlNode.PrependChild(XmlNode) Methode

  • Referenz

Definition

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

Fügt den angegebenen Knoten am Anfang der Liste der untergeordneten Knoten dieses Knotens hinzu.

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

Parameter

newChild
XmlNode

Der hinzuzufügende Knoten. Der gesamte Inhalt des hinzuzufügenden Knotens wird an den angegebenen Speicherort verschoben.

Gibt zurück

XmlNode

Der hinzugefügte Knoten.

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.

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->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

Hinweise

Wenn sich die newChild Struktur bereits befindet, wird sie aus 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-Objektmodell (DOM).

Hinweise für Vererber

Wenn sie in einer abgeleiteten Klasse außer Kraft PrependChild gesetzt werden, müssen Sie die PrependChild Methode der Basisklasse aufrufen, damit Ereignisse ordnungsgemäß ausgelöst werden.

Gilt für

Siehe auch