XmlNode.AppendChild(XmlNode) Metódus

Definíció

Névtér:

System.Xml

Szerelvények:

netstandard.dll, System.Xml.ReaderWriter.dll

Forrás:

XmlNode.cs

Hozzáadja a megadott csomópontot a csomópont gyermekcsomópontjai listájának végéhez.

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.XmlNode

Public Overridable Function AppendChild (newChild As XmlNode) As XmlNode

Paraméterek

newChild

XmlNode

A hozzáadni kívánt csomópont. A hozzáadandó csomópont összes tartalma a megadott helyre kerül.

Válaszok

XmlNode

A hozzáadott csomópont.

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.

Példák

Az alábbi példa egy új csomópontot ad hozzá az XML-dokumentumhoz.

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

Output:

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>

Megjegyzések

Ha a newChild fa már szerepel a fán, akkor a rendszer eltávolítja az eredeti pozíciójából, és hozzáadja a célpozícióhoz. További információ a csomópontok beszúrásáról: Csomópontok beszúrása XML-dokumentumba.

Ha a beszúrt csomópont egy másik dokumentumból lett létrehozva, importálhatja XmlDocument.ImportNode a csomópontot az aktuális dokumentumba. Az importált csomópont ezután beilleszthető az aktuális dokumentumba.

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

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

Lásd még

• ImportNode(XmlNode, Boolean)
• Csomópontok beszúrása XML-dokumentumba