XmlNode.ReplaceChild(XmlNode, XmlNode) Methode

Definitie

Naamruimte:
System.Xml
Assembly's:
System.Xml.dll, System.Xml.XmlDocument.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Vervangt het onderliggende knooppunt oldChild door newChild het knooppunt.

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

Parameters

newChild
XmlNode

Het nieuwe knooppunt dat in de onderliggende lijst moet worden geplaatst.

oldChild
XmlNode

Het knooppunt dat in de lijst wordt vervangen.

Retouren

XmlNode

Het knooppunt is vervangen.

Uitzonderingen

InvalidOperationException

Dit knooppunt is van een type dat geen onderliggende knooppunten van het type newChild knooppunt toestaat.

Het newChild is een bovenliggend element van dit knooppunt.

ArgumentException

De newChild is gemaakt op basis van een ander document dan het document dat dit knooppunt heeft gemaakt.

Dit knooppunt heeft het kenmerk Alleen-lezen.

Het oldChild is geen onderliggend element van dit knooppunt.

Voorbeelden

In het volgende voorbeeld wordt het titelelement in het XML-document vervangen.

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 title element.
    XmlElement elem = doc.CreateElement("title");
    elem.InnerText="The Handmaid's Tale";

    //Replace the title element.
    root.ReplaceChild(elem, root.FirstChild);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);
  }
}

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 title element.
        Dim elem As XmlElement = doc.CreateElement("title")
        elem.InnerText = "The Handmaid's Tale"
        
        'Replace the title element.
        root.ReplaceChild(elem, root.FirstChild)
        
        Console.WriteLine("Display the modified XML...")
        doc.Save(Console.Out)
    End Sub
End Class

Opmerkingen

Als de newChild structuur zich al in de structuur bevindt, wordt deze eerst verwijderd.

Als het newChild is gemaakt op basis van een ander document, kunt XmlDocument.ImportNode u het knooppunt importeren in het huidige document. Het geïmporteerde knooppunt kan vervolgens worden doorgegeven aan de ReplaceChild methode.

Notities voor overnemers

Wanneer u ReplaceChild overschrijft in een afgeleide klasse, moet u de ReplaceChild methode van de basisklasse aanroepen om gebeurtenissen correct te kunnen genereren.

Van toepassing op

Zie ook