XmlAttributeCollection.Append(XmlAttribute) Método

Definición

Espacio de nombres:

System.Xml

Ensamblados:

System.Xml.dll, System.Xml.XmlDocument.dll

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.XmlDocument.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Inserta el atributo especificado como último nodo de la colección.

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

Parámetros

node

XmlAttribute

Atributo que se va a insertar.

Devoluciones

XmlAttribute

XmlAttribute que se va a agregar a la colección.

Excepciones

ArgumentException

Se creó node a partir de un documento diferente que el que creó esta colección.

Ejemplos

En el ejemplo siguiente se agrega un nuevo atributo a un documento.

#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

Comentarios

Si un atributo con el mismo nombre ya está presente en la colección, el atributo original se quita de la colección y node se agrega al final de la colección.

Este método es una extensión de Microsoft al Modelo de objetos de documento (DOM).