XmlElement.SetAttributeNode Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Ajoute un nouveau XmlAttribute.

Surcharges

SetAttributeNode(XmlAttribute)	Ajoute le XmlAttribute spécifié.
SetAttributeNode(String, String)	Ajoute le XmlAttribute spécifié.

SetAttributeNode(XmlAttribute)

Source:

XmlElement.cs

Ajoute le XmlAttribute spécifié.

public:
 virtual System::Xml::XmlAttribute ^ SetAttributeNode(System::Xml::XmlAttribute ^ newAttr);

public virtual System.Xml.XmlAttribute? SetAttributeNode (System.Xml.XmlAttribute newAttr);

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

Public Overridable Function SetAttributeNode (newAttr As XmlAttribute) As XmlAttribute

Paramètres

newAttr

XmlAttribute

Nœud XmlAttribute à ajouter à la collection d'attributs de cet élément.

Retours

XmlAttribute

Si l'attribut remplace un attribut existant portant le même nom, l'ancien XmlAttribute est retourné ; sinon, null est retournée.

Exceptions

ArgumentException

newAttr a été créé à partir d'un document différent de celui qui a créé ce nœud. ou bien ce nœud est en lecture seule.

InvalidOperationException

newAttr est déjà l'attribut d'un autre objet XmlElement. Vous devez explicitement cloner les nœuds XmlAttribute pour les réutiliser dans d'autres objets XmlElement.

Remarques

Si un attribut portant ce nom est déjà présent dans l’élément, il est remplacé par le nouveau.

SetAttributeNode(String, String)

Source:

XmlElement.cs

Ajoute le XmlAttribute spécifié.

public:
 virtual System::Xml::XmlAttribute ^ SetAttributeNode(System::String ^ localName, System::String ^ namespaceURI);

public virtual System.Xml.XmlAttribute SetAttributeNode (string localName, string? namespaceURI);

abstract member SetAttributeNode : string * string -> System.Xml.XmlAttribute
override this.SetAttributeNode : string * string -> System.Xml.XmlAttribute

Public Overridable Function SetAttributeNode (localName As String, namespaceURI As String) As XmlAttribute

Paramètres

localName

String

Le nom local de l'attribut.

namespaceURI

String

L'URI de l'espace de noms de l'attribut.

Retours

XmlAttribute

XmlAttribute à ajouter.

Exemples

L’exemple suivant ajoute un attribut à un élément .

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew XmlDocument;
   doc->LoadXml( "<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'><title>Pride And Prejudice</title></book>" );
   XmlElement^ root = doc->DocumentElement;
   
   // Add a new attribute.
   XmlAttribute^ attr = root->SetAttributeNode( "genre", "urn:samples" );
   attr->Value = "novel";
   Console::WriteLine( "Display the modified XML..." );
   Console::WriteLine( doc->InnerXml );
}

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlElement root = doc.DocumentElement;

    // Add a new attribute.
    XmlAttribute attr = root.SetAttributeNode("genre", "urn:samples");
    attr.Value="novel";

    Console.WriteLine("Display the modified XML...");
    Console.WriteLine(doc.InnerXml);
  }
}

Imports System.IO
Imports System.Xml

public class Sample

  public shared sub Main()

    Dim doc as XmlDocument = new XmlDocument()
    doc.LoadXml("<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'>" & _
                "<title>Pride And Prejudice</title>" & _
                "</book>")

    Dim root as XmlElement = doc.DocumentElement

    ' Add a new attribute.
    Dim attr as XmlAttribute = root.SetAttributeNode("genre", "urn:samples")
    attr.Value="novel"

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

  end sub
end class

Remarques

le XmlAttribute n’a pas d’enfants. Permet Value d’affecter une valeur de texte à l’attribut ou d’utiliser AppendChild (ou une méthode similaire) pour ajouter des enfants à l’attribut.