XmlAttributeCollection::Prepend Method (XmlAttribute^)

 

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

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

public:
XmlAttribute^ Prepend(
	XmlAttribute^ node
)

Parameters

node
Type: System.Xml::XmlAttribute^

The XmlAttribute to insert.

Return Value

Type: System.Xml::XmlAttribute^

The XmlAttribute added to the 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 beginning 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.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->Prepend( 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: