XmlNode.PrependChild(XmlNode) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Xml
Assembly:
System.Xml.dll, System.Xml.XmlDocument.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XmlDocument.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Aggiunge il nodo specificato all'inizio dell'elenco dei nodi figlio del nodo corrente.

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

Parametri

newChild
XmlNode

Nodo da aggiungere. L'intero contenuto del nodo da aggiungere viene spostato nel percorso specificato.

Restituisce

XmlNode

Nodo aggiunto.

Eccezioni

InvalidOperationException

Per questo tipo di nodi non sono consentiti elementi figlio di tipo newChild.

newChild è un predecessore di questo nodo.

ArgumentException

Il nodo newChild è stato creato da un documento diverso da quello che ha creato il nodo corrente.

Il nodo è di sola lettura.

Esempio

Nell'esempio seguente viene aggiunto un nuovo nodo al documento XML.

#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

Commenti

Se l'oggetto newChild è già presente nell'albero, viene rimosso dalla posizione originale e aggiunto alla posizione di destinazione. Per altre informazioni sull'inserimento di nodi, vedere Inserimento di nodi in un documento XML.

Se il nodo da inserire è stato creato da un altro documento, è possibile usare XmlDocument.ImportNode per importare il nodo nel documento corrente. Il nodo importato può quindi essere inserito nel documento corrente.

Questo metodo è un'estensione Microsoft per il dom (Document Object Model).

Note per gli eredi

Quando si esegue l'override PrependChild in una classe derivata, affinché gli eventi vengano generati correttamente, è necessario chiamare il PrependChild metodo della classe base.

Si applica a

Vedi anche