XmlAttributeCollection.Append-Methode

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

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Function Append ( _
    node As XmlAttribute _
) As XmlAttribute
'Usage
Dim instance As XmlAttributeCollection
Dim node As XmlAttribute
Dim returnValue As XmlAttribute

returnValue = instance.Append(node)

public XmlAttribute Append (
    XmlAttribute node
)

public:
XmlAttribute^ Append (
    XmlAttribute^ node
)

public XmlAttribute Append (
    XmlAttribute node
)

public function Append (
    node : XmlAttribute
) : XmlAttribute

Parameter

• node
  Das einzufügende XmlAttribute.

Rückgabewert

Das an die Auflistung anzufügende XmlAttribute.

Ausnahmen

Hinweise

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

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

Beispiel

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

Imports System
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

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);  
  }
}

#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 );
}

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    public static void main(String[] args)
    {
        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.set_Value("novel");

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

        Console.WriteLine("Display the modified XML...\r\n");
        Console.WriteLine(doc.get_OuterXml());
    } //main
} //Sample

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlAttributeCollection-Klasse
XmlAttributeCollection-Member
System.Xml-Namespace