XmlNode.ReplaceChild(XmlNode, XmlNode) Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlNode.cs

Nahradí podřízený uzel oldChildnewChild uzlem.

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

Parametry

newChild

XmlNode

Nový uzel, který se má vložit do podřízeného seznamu.

oldChild

XmlNode

Uzel, který se nahrazuje v seznamu.

Návraty

XmlNode

Uzel byl nahrazen.

Výjimky

InvalidOperationException

Tento uzel je typu, který neumožňuje podřízené uzly typu newChild uzlu.

Jedná se newChild o nadřazený uzel.

ArgumentException

Byl newChild vytvořen z jiného dokumentu než z dokumentu, který vytvořil tento uzel.

Tento uzel je jen pro čtení.

Není podřízenou oldChild položkou tohoto uzlu.

Příklady

Následující příklad nahrazuje element title v dokumentu XML.

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

Poznámky

Pokud je již ve newChild stromu, je nejprve odebrán.

newChild Pokud byl vytvořen z jiného dokumentu, můžete ho použít XmlDocument.ImportNode k importu uzlu do aktuálního dokumentu. Importovaný uzel pak lze metodě předat ReplaceChild .

Poznámky pro dědice

Při přepsání ReplaceChild v odvozené třídě, aby události byly vyvolány správně, je nutné volat ReplaceChild metodu základní třídy.

Viz také

• ImportNode(XmlNode, Boolean)