XmlAttributeCollection.Append(XmlAttribute) Methode

Definition

Fügt das angegebene Attribut als letzten Knoten in die Auflistung ein.

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

Parameter

node
XmlAttribute

Das einzufügende Attribut.

Gibt zurück

Der an die Auflistung anzufügende XmlAttribute.

Ausnahmen

node wurde aus einem anderen Dokument als dem erstellt, das diese Auflistung erstellt hat.

Beispiele

Im folgenden Beispiel wird einem Dokument ein neues Attribut hinzugefügt.

#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

Hinweise

Wenn ein Attribut mit demselben Namen bereits in der Auflistung vorhanden ist, wird das ursprüngliche Attribut aus der Auflistung entfernt und node am Ende der Auflistung hinzugefügt.

Diese Methode ist eine Microsoft Erweiterung des Document Object Model (DOM).

Gilt für: