XmlNode.ReplaceChild(XmlNode, XmlNode) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Ersätter den underordnade noden oldChild med newChild noden.
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
Parametrar
- newChild
- XmlNode
Den nya noden som ska placeras i den underordnade listan.
- oldChild
- XmlNode
Noden som ersätts i listan.
Returer
Noden har ersatts.
Undantag
Den här noden är av en typ som inte tillåter underordnade noder av nodens newChild typ.
newChild är en överordnad till den här noden.
Skapades newChild från ett annat dokument än det som skapade den här noden.
Den här noden är skrivskyddad.
är inte underordnad oldChild den här noden.
Exempel
I följande exempel ersätts rubrikelementet i XML-dokumentet.
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
Kommentarer
Om det newChild redan finns i trädet tas det först bort.
Om det newChild skapades från ett annat dokument kan du använda XmlDocument.ImportNode för att importera noden till det aktuella dokumentet. Den importerade noden kan sedan skickas till ReplaceChild metoden.
Anteckningar till arvingar
När du åsidosättar ReplaceChild i en härledd klass måste du anropa metoden för basklassen ReplaceChild för att händelser ska kunna aktiveras korrekt.