XmlAttributeCollection.InsertBefore(XmlAttribute, XmlAttribute) Método

Definición

Espacio de nombres:
System.Xml
Ensamblados:
System.Xml.dll, System.Xml.XmlDocument.dll
Ensamblados:
netstandard.dll, System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.XmlDocument.dll
Ensamblado:
System.Xml.ReaderWriter.dll
Ensamblado:
System.Xml.dll
Ensamblado:
netstandard.dll
Source:
XmlAttributeCollection.cs
Source:
XmlAttributeCollection.cs
Source:
XmlAttributeCollection.cs
Source:
XmlAttributeCollection.cs
Source:
XmlAttributeCollection.cs

Inserta el atributo especificado inmediatamente antes del atributo de referencia especificado.

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

Parámetros

newNode
XmlAttribute

Atributo que se va a insertar.

refNode
XmlAttribute

Atributo de referencia. newNode se coloca antes de refNode.

Devoluciones

XmlAttribute

que XmlAttribute se va a insertar en la colección.

Excepciones

ArgumentException

newNode se creó a partir de un documento diferente del que creó esta colección. O bien, no refNode es miembro de esta colección.

Ejemplos

En el ejemplo siguiente se agrega un nuevo atributo a un documento.

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

Comentarios

Si un atributo con el mismo nombre ya está presente en la colección, el atributo original se quita de la colección y newNode se inserta en la colección. Si refNode es null, newNode se inserta al final de la colección.

Este método es una extensión Microsoft al modelo de objetos de documento (DOM).

Se aplica a