XmlNode.AppendChild(XmlNode) Método
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.
Adiciona o nó especificado ao final da lista de nós filho desse nó.
public:
virtual System::Xml::XmlNode ^ AppendChild(System::Xml::XmlNode ^ newChild);public virtual System.Xml.XmlNode AppendChild (System.Xml.XmlNode newChild);public virtual System.Xml.XmlNode? AppendChild (System.Xml.XmlNode newChild);abstract member AppendChild : System.Xml.XmlNode -> System.Xml.XmlNode
override this.AppendChild : System.Xml.XmlNode -> System.Xml.XmlNodePublic Overridable Function AppendChild (newChild As XmlNode) As XmlNode- newChild
- XmlNode
O nó a ser adicionado. Todo o conteúdo do nó a ser adicionado é movido para o local especificado.
O nó adicionado.
Esse nó é de um tipo que não permite nós filho do tipo do nó newChild.
O newChild é um ancestral desse nó.
O newChild foi criado com base em um documento diferente daquele que criou esse nó.
Este nó é somente leitura.
O exemplo a seguir adiciona um novo nó ao documento XML.
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
XmlDocument^ doc = gcnew XmlDocument;
doc->LoadXml( "<book genre='novel' ISBN='1-861001-57-5'>"
"<title>Pride And Prejudice</title>"
"</book>" );
XmlNode^ root = doc->DocumentElement;
//Create a new node.
XmlElement^ elem = doc->CreateElement( "price" );
elem->InnerText = "19.95";
//Add the node to the document.
root->AppendChild( elem );
Console::WriteLine( "Display the modified XML..." );
doc->Save( Console::Out );
}
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 node.
XmlElement elem = doc.CreateElement("price");
elem.InnerText="19.95";
//Add the node to the document.
root.AppendChild(elem);
Console.WriteLine("Display the modified XML...");
doc.Save(Console.Out);
}
}
Option Explicit
Option Strict
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 node.
Dim elem As XmlElement = doc.CreateElement("price")
elem.InnerText = "19.95"
'Add the node to the document.
root.AppendChild(elem)
Console.WriteLine("Display the modified XML...")
doc.Save(Console.Out)
End Sub
End Class
Saída:
Display the modified XML...
<?xml version="1.0" encoding="IBM437"?>
<book genre="novel" ISBN="1-861001-57-5">
<title>Pride And Prejudice</title>
<price>19.95</price>
Se o newChild já estiver na árvore, ele será removido de sua posição original e adicionado à sua posição de destino. Para obter mais informações sobre como inserir nós, consulte Inserir nós em um documento XML.
Se o nó que está sendo inserido foi criado a partir de outro documento, você pode usar XmlDocument.ImportNode para importar o nó para o documento atual. Em seguida, o nó importado pode ser inserido no documento atual.
Ao substituir AppendChild em uma classe derivada, para que os eventos sejam gerados corretamente, você deve chamar o AppendChild método da classe base.
| Produto | Versões |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| .NET Standard | 2.0, 2.1 |
| UWP | 10.0 |