XmlNode.ReplaceChild(XmlNode, XmlNode) Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlNode.cs

A gyermekcsomópontot oldChild csomópontra newChild cseréli.

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

Paraméterek

newChild

XmlNode

A gyermeklistában elhelyezendő új csomópont.

oldChild

XmlNode

A listában lecserélt csomópont.

Válaszok

XmlNode

A csomópont lecserélve.

Kivételek

InvalidOperationException

Ez a csomópont olyan típusú, amely nem engedélyezi a csomópont típusának gyermekcsomópontjait newChild .

A newChild csomópont őse.

ArgumentException

A newChild csomópontot létrehozó dokumentumtól eltérő dokumentumból lett létrehozva.

Ez a csomópont írásvédett.

Ez oldChild nem ennek a csomópontnak a gyermeke.

Példák

Az alábbi példa az XML-dokumentum címelemét cseréli le.

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

Megjegyzések

Ha a newChild fa már szerepel a fán, először eltávolítja.

Ha a newChild fájlt egy másik dokumentumból hozták létre, a csomópontot importálhatja XmlDocument.ImportNode az aktuális dokumentumba. Az importált csomópont ezután átadható a ReplaceChild metódusnak.

Megjegyzések az öröklőkhöz

Származtatott osztály felülírásakor ReplaceChild az események helyes előhívásához meg kell hívnia az ReplaceChild alaposztály metódusát.

Lásd még

• ImportNode(XmlNode, Boolean)