XmlAttributeCollection.InsertBefore(XmlAttribute, XmlAttribute) XmlAttributeCollection.InsertBefore(XmlAttribute, XmlAttribute) XmlAttributeCollection.InsertBefore(XmlAttribute, XmlAttribute) XmlAttributeCollection.InsertBefore(XmlAttribute, XmlAttribute) Method

Определение

Вставляет указанный атрибут непосредственно перед заданным атрибутом ссылки.Inserts the specified attribute immediately before the specified reference attribute.

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);
member this.InsertBefore : System.Xml.XmlAttribute * System.Xml.XmlAttribute -> System.Xml.XmlAttribute
Public Function InsertBefore (newNode As XmlAttribute, refNode As XmlAttribute) As XmlAttribute

Параметры

newNode
XmlAttribute XmlAttribute XmlAttribute XmlAttribute

Атрибут для вставки.The attribute to insert.

refNode
XmlAttribute XmlAttribute XmlAttribute XmlAttribute

Ссылочный атрибут.The reference attribute. Элемент newNode помещается перед элементом refNode.newNode is placed before the refNode.

Возвраты

Объект XmlAttribute для вставки в коллекцию.The XmlAttribute to insert into the collection.

Исключения

newNode был создан из документа, отличающегося от того, который создал данную коллекцию.The newNode was created from a document different from the one that created this collection. Или refNode не является членом данной коллекции.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
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

Комментарии

Если в коллекции уже имеется атрибут с таким же именем, исходный атрибут удаляется из коллекции и newNode вставляется в коллекцию.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. Если refNode параметр nullимеет newNode значение, вставляется в конец коллекции.If refNode is null, newNode is inserted at the end of the collection.

Этот метод является расширением Майкрософт для модель DOM (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Применяется к