XmlNode.ReplaceChild(XmlNode, XmlNode) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Substitui o nó oldChild filho pelo newChild nó.
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.XmlNodePublic Overridable Function ReplaceChild (newChild As XmlNode, oldChild As XmlNode) As XmlNodeParâmetros
- newChild
- XmlNode
O novo nó a ser colocado na lista filho.
- oldChild
- XmlNode
O nó que está sendo substituído na lista.
Retornos
O nó substituído.
Exceções
Esse nó é de um tipo que não permite nós filho do tipo do newChild nó.
O newChild é um ancestral deste nó.
O newChild foi criado a partir de um documento diferente daquele que criou esse nó.
Este nó é somente leitura.
O oldChild não é um filho deste nó.
Exemplos
O exemplo a seguir substitui o elemento de título no documento 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
Comentários
Se o newChild já estiver na árvore, ele será removido pela primeira vez.
Se o newChild documento foi criado com base em outro documento, você pode usar XmlDocument.ImportNode para importar o nó para o documento atual. Em seguida, o nó importado pode ser passado para o ReplaceChild método.
Notas aos Herdeiros
Ao substituir ReplaceChild em uma classe derivada, para que os eventos sejam gerados corretamente, você deve chamar o ReplaceChild método da classe base.
