XmlAttributeCollection.Append(XmlAttribute) Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestawy:

netstandard.dll, System.Xml.ReaderWriter.dll

Źródło:

XmlAttributeCollection.cs

Wstawia określony atrybut jako ostatni węzeł w kolekcji.

public:
 System::Xml::XmlAttribute ^ Append(System::Xml::XmlAttribute ^ node);

public System.Xml.XmlAttribute Append(System.Xml.XmlAttribute node);

member this.Append : System.Xml.XmlAttribute -> System.Xml.XmlAttribute

Public Function Append (node As XmlAttribute) As XmlAttribute

Parametry

node

XmlAttribute

Atrybut do wstawienia.

Zwraca

XmlAttribute

Element XmlAttribute do dołączania do kolekcji.

Wyjątki

ArgumentException

node został utworzony na podstawie dokumentu innego niż ten, który utworzył tę kolekcję.

Przykłady

Poniższy przykład dodaje nowy atrybut do dokumentu.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main(){

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    //Create a new attribute.
    XmlAttribute newAttr = doc.CreateAttribute("genre");
    newAttr.Value = "novel";

    //Create an attribute collection and add the new attribute
    //to the collection.
    XmlAttributeCollection attrColl = doc.DocumentElement.Attributes;
    attrColl.Append(newAttr);

    Console.WriteLine("Display the modified XML...\r\n");
    Console.WriteLine(doc.OuterXml);
  }
}

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()
  
    Dim doc as XmlDocument = new XmlDocument()
    doc.LoadXml("<book ISBN='1-861001-57-5'>" & _
                "<title>Pride And Prejudice</title>" & _
                "</book>")      

    'Create a new attribute.
    Dim newAttr as XmlAttribute = doc.CreateAttribute("genre")
    newAttr.Value = "novel"

    'Create an attribute collection and add the new attribute
    'to the collection.  
    Dim attrColl as XmlAttributeCollection = doc.DocumentElement.Attributes
    attrColl.Append(newAttr)

    Console.WriteLine("Display the modified XML...")
    Console.WriteLine(doc.OuterXml)

  end sub
end class

Uwagi

Jeśli atrybut o tej samej nazwie jest już obecny w kolekcji, oryginalny atrybut zostanie usunięty z kolekcji i node zostanie dodany na końcu kolekcji.

Ta metoda jest rozszerzeniem Microsoft do modelu obiektów dokumentów (DOM).