XmlAttributeCollection.InsertBefore(XmlAttribute, XmlAttribute) Metoda

Definicja

Przestrzeń nazw:

System.Xml

Zestawy:

System.Xml.dll, System.Xml.XmlDocument.dll

Zestaw:

System.Xml.ReaderWriter.dll

Zestaw:

System.Xml.XmlDocument.dll

Zestaw:

System.Xml.dll

Zestaw:

netstandard.dll

Wstawia określony atrybut bezpośrednio przed określonym atrybutem odwołania.

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

Parametry

newNode

XmlAttribute

Atrybut do wstawienia.

refNode

XmlAttribute

Atrybut odwołania. newNode element jest umieszczany przed elementem refNode.

Zwraca

XmlAttribute

Element XmlAttribute do wstawienia do kolekcji.

Wyjątki

ArgumentException

Obiekt newNode został utworzony na podstawie dokumentu innego niż ten, który utworzył tę kolekcję. Lub element refNode nie jest członkiem tej kolekcji.

Przykłady

Poniższy przykład dodaje nowy atrybut do dokumentu.

#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

Uwagi

Jeśli atrybut o tej samej nazwie jest już obecny w kolekcji, oryginalny atrybut zostanie usunięty z kolekcji i newNode zostanie wstawiony do kolekcji. Jeśli refNode parametr ma nullwartość , newNode zostanie wstawiony na końcu kolekcji.

Ta metoda jest rozszerzeniem firmy Microsoft do modelu obiektów dokumentów (DOM).