XmlAttributeCollection.Append(XmlAttribute) Méthode

Référence

Définition

Espace de noms:: System.Xml

Assemblys:: System.Xml.dll, System.Xml.XmlDocument.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XmlDocument.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Insère l'attribut spécifié en tant que dernier nœud de la collection.

public:
 System::Xml::XmlAttribute ^ Append(System::Xml::XmlAttribute ^ node);

public:
 virtual System::Xml::XmlAttribute ^ Append(System::Xml::XmlAttribute ^ node);

public System.Xml.XmlAttribute Append (System.Xml.XmlAttribute node);

public virtual System.Xml.XmlAttribute Append (System.Xml.XmlAttribute node);

member this.Append : System.Xml.XmlAttribute -> System.Xml.XmlAttribute

abstract member Append : System.Xml.XmlAttribute -> System.Xml.XmlAttribute
override this.Append : System.Xml.XmlAttribute -> System.Xml.XmlAttribute

Public Function Append (node As XmlAttribute) As XmlAttribute

Public Overridable Function Append (node As XmlAttribute) As XmlAttribute

Paramètres

node: XmlAttribute

Attribut à insérer.

Retours

XmlAttribute

XmlAttribute à ajouter à la collection.

Exceptions

ArgumentException

node a été créé à partir d'un document différent de celui qui a créé cette collection.

Exemples

L’exemple suivant ajoute un nouvel attribut à un 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->Append( newAttr );
   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.Append(newAttr);

    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.Append(newAttr)

    Console.WriteLine("Display the modified XML...")
    Console.WriteLine(doc.OuterXml)

  end sub
end class

Remarques

Si un attribut portant le même nom est déjà présent dans la collection, l’attribut d’origine est supprimé de la collection et node est ajouté à la fin de la collection.

Cette méthode est une extension Microsoft au modèle objet document (DOM).

S’applique à

Partager via