XmlAttributeCollection.Append Method (XmlAttribute)

 

Inserts the specified attribute as the last node in the collection.

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

public XmlAttribute Append(
	XmlAttribute node
)

Parameters

node
Type: System.Xml.XmlAttribute

The XmlAttribute to insert.

Return Value

Type: System.Xml.XmlAttribute

The XmlAttribute to append to the collection.

Exception Condition
ArgumentException

node was created from a document different from the one that created this collection.

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.

This method is a Microsoft extension to the Document Object Model (DOM).

The following example adds a new attribute to a document.

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

Universal Windows Platform
Available since 10
.NET Framework
Available since 1.1
Return to top
Show: