XmlNode.AppendChild(XmlNode) Metod

Definition

Namnområde:
System.Xml
Sammansättningar:
System.Xml.dll, System.Xml.XmlDocument.dll
Sammansättningar:
netstandard.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.XmlDocument.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
netstandard.dll
Källa:
XmlNode.cs
Källa:
XmlNode.cs
Källa:
XmlNode.cs
Källa:
XmlNode.cs
Källa:
XmlNode.cs

Lägger till den angivna noden i slutet av listan över underordnade noder för den här noden.

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.XmlNode
Public Overridable Function AppendChild (newChild As XmlNode) As XmlNode

Parametrar

newChild
XmlNode

Noden som ska läggas till. Allt innehåll i noden som ska läggas till flyttas till den angivna platsen.

Returer

XmlNode

Noden har lagts till.

Undantag

InvalidOperationException

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.

ArgumentException

Skapades newChild från ett annat dokument än det som skapade den här noden.

Den här noden är skrivskyddad.

Exempel

I följande exempel läggs en ny nod till 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 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>

Kommentarer

Om den newChild redan finns i trädet tas den bort från sin ursprungliga position och läggs till i målpositionen. Mer information om hur du infogar noder finns i Infoga noder i ett XML-dokument.

Om noden som infogades 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 infogas i det aktuella dokumentet.

Anteckningar till arvingar

När du åsidosättar AppendChild i en härledd klass måste du anropa metoden för basklassen AppendChild för att händelser ska kunna aktiveras korrekt.

Gäller för

Se även