Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

XmlAttributeCollection::InsertBefore Method (XmlAttribute^, XmlAttribute^)

 

Inserts the specified attribute immediately before the specified reference attribute.

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

public:
XmlAttribute^ InsertBefore(
	XmlAttribute^ newNode,
	XmlAttribute^ refNode
)

Parameters

newNode
Type: System.Xml::XmlAttribute^

The XmlAttribute to insert.

refNode
Type: System.Xml::XmlAttribute^

The XmlAttribute that is the reference attribute. newNode is placed before the refNode.

Return Value

Type: System.Xml::XmlAttribute^

The XmlAttribute to insert into the collection.

Exception Condition
ArgumentException

The newNode was created from a document different from the one that created this collection. Or the refNode is not a member of this collection.

If an attribute with the same name is already present in the collection, the original attribute is removed from the collection and newNode is inserted into the collection. If refNode is null, newNode is inserted at 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.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->InsertBefore( newAttr, attrColl[ 0 ] );
   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:
© 2017 Microsoft