XmlAttributeCollection.InsertBefore(XmlAttribute, XmlAttribute) Methode

Definition

Fügt das angegebene Attribut direkt vor dem angegebenen Verweisattribut ein.Inserts the specified attribute immediately before the specified reference attribute.

public:
 virtual 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);
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 Overridable Function InsertBefore (newNode As XmlAttribute, refNode As XmlAttribute) As XmlAttribute

Parameter

newNode
XmlAttribute

Das einzufügende Attribut.The attribute to insert.

refNode
XmlAttribute

Das Verweisattribut.The reference attribute. newNode wird vor refNode platziert.newNode is placed before the refNode.

Gibt zurück

Die in die Auflistung einzufügende XmlAttribute-Klasse.The XmlAttribute to insert into the collection.

Ausnahmen

newNode wurde aus einem anderen Dokument als dem erstellt, das diese Auflistung erstellt hat.The newNode was created from a document different from the one that created this collection. Oder refNode ist kein Member dieser Auflistung.Or the refNode is not a member of this collection.

Beispiele

Im folgenden Beispiel wird einem Dokument ein neues Attribut hinzugefügt.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

Hinweise

Wenn ein Attribut mit demselben Namen bereits in der Auflistung vorhanden ist, wird das ursprüngliche Attribut aus der Auflistung entfernt und newNode in die Auflistung eingefügt.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. Wenn refNode nullist, wird newNode am Ende der Auflistung eingefügt.If refNode is null, newNode is inserted at the end of the collection.

Diese Methode ist eine Microsoft-Erweiterung für die Dokumentobjektmodell (DOM).This method is a Microsoft extension to the Document Object Model (DOM).

Gilt für: