XmlAttributeCollection.Append(XmlAttribute) Metoda

Definicja

Przestrzeń nazw:
System.Xml
Zestawy:
System.Xml.dll, System.Xml.XmlDocument.dll
Zestaw:
System.Xml.ReaderWriter.dll
Zestaw:
netstandard.dll
Zestaw:
System.Xml.XmlDocument.dll
Zestaw:
System.Xml.dll

Wstawia określony atrybut jako ostatni węzeł w kolekcji.Inserts the specified attribute as the last node in the collection.

public:
 System::Xml::XmlAttribute ^ Append(System::Xml::XmlAttribute ^ node);
public:
 virtual System::Xml::XmlAttribute ^ Append(System::Xml::XmlAttribute ^ node);
public System.Xml.XmlAttribute Append (System.Xml.XmlAttribute node);
public virtual System.Xml.XmlAttribute Append (System.Xml.XmlAttribute node);
member this.Append : System.Xml.XmlAttribute -> System.Xml.XmlAttribute
abstract member Append : System.Xml.XmlAttribute -> System.Xml.XmlAttribute
override this.Append : System.Xml.XmlAttribute -> System.Xml.XmlAttribute
Public Function Append (node As XmlAttribute) As XmlAttribute
Public Overridable Function Append (node As XmlAttribute) As XmlAttribute

Parametry

node
XmlAttribute

Atrybut, który ma zostać wstawiony.The attribute to insert.

Zwraca

XmlAttribute

XmlAttributeDo dołączenia do kolekcji.The XmlAttribute to append to the collection.

Wyjątki

ArgumentException

node został utworzony na podstawie dokumentu innego niż ten, który utworzył tę kolekcję.node was created from a document different from the one that created this collection.

Przykłady

Poniższy przykład dodaje nowy atrybut do dokumentu.The following example adds a new attribute to a document.

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew 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 );
}


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 już istnieje w kolekcji, oryginalny atrybut zostanie usunięty z kolekcji i node zostanie dodany na końcu kolekcji.If an attribute with the same name is already present in the collection, the original attribute is removed from the collection and node is added to the end of the collection.

Ta metoda jest rozszerzeniem firmy Microsoft do Document Object Model (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Dotyczy