XmlAttributeCollection.InsertBefore(XmlAttribute, XmlAttribute) Method
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Inserts the specified attribute immediately before the specified reference attribute.
public:
System::Xml::XmlAttribute ^ InsertBefore(System::Xml::XmlAttribute ^ newNode, System::Xml::XmlAttribute ^ refNode);
public:
virtual System::Xml::XmlAttribute ^ InsertBefore(System::Xml::XmlAttribute ^ newNode, System::Xml::XmlAttribute ^ refNode);
public System.Xml.XmlAttribute InsertBefore (System.Xml.XmlAttribute newNode, System.Xml.XmlAttribute refNode);
public System.Xml.XmlAttribute InsertBefore (System.Xml.XmlAttribute newNode, System.Xml.XmlAttribute? refNode);
public virtual System.Xml.XmlAttribute InsertBefore (System.Xml.XmlAttribute newNode, System.Xml.XmlAttribute refNode);
member this.InsertBefore : System.Xml.XmlAttribute * System.Xml.XmlAttribute -> System.Xml.XmlAttribute
abstract member InsertBefore : System.Xml.XmlAttribute * System.Xml.XmlAttribute -> System.Xml.XmlAttribute
override this.InsertBefore : System.Xml.XmlAttribute * System.Xml.XmlAttribute -> System.Xml.XmlAttribute
Public Function InsertBefore (newNode As XmlAttribute, refNode As XmlAttribute) As XmlAttribute
Public Overridable Function InsertBefore (newNode As XmlAttribute, refNode As XmlAttribute) As XmlAttribute
- newNode
- XmlAttribute
The attribute to insert.
- refNode
- XmlAttribute
The reference attribute. newNode
is placed before the refNode
.
The XmlAttribute
to insert into the collection.
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.
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 );
}
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.InsertBefore(newAttr, attrColl[0]);
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.InsertBefore(newAttr, attrColl.ItemOf(0))
Console.WriteLine("Display the modified XML...")
Console.WriteLine(doc.OuterXml)
end sub
end class
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).
Product | Versions |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
UWP | 10.0 |
.NET feedback
.NET is an open source project. Select a link to provide feedback: