Partager via


XElement.SetAttributeValue(XName, Object) Méthode

Définition

Définit la valeur d'un attribut, ajoute un attribut ou supprime un attribut.

public:
 void SetAttributeValue(System::Xml::Linq::XName ^ name, System::Object ^ value);
public void SetAttributeValue (System.Xml.Linq.XName name, object value);
public void SetAttributeValue (System.Xml.Linq.XName name, object? value);
member this.SetAttributeValue : System.Xml.Linq.XName * obj -> unit
Public Sub SetAttributeValue (name As XName, value As Object)

Paramètres

name
XName

XName qui contient le nom de l'attribut à modifier.

value
Object

Valeur à assigner à l'attribut. L'attribut est supprimé si la valeur est null. Sinon, la valeur est convertie en sa représentation sous forme de chaîne et assignée à la propriété Value de l'attribut.

Exceptions

La value est une instance de XObject.

Exemples

L’exemple suivant crée un élément avec un attribut . Il utilise ensuite cette méthode pour remplacer le contenu de l’attribut.

// Create an element with no content.
XElement root = new XElement("Root");

// Add some name/value pairs.
root.SetAttributeValue("Att1", 1);
root.SetAttributeValue("Att2", 2);
root.SetAttributeValue("Att3", 3);
Console.WriteLine(root);

// Modify one of the name/value pairs.
root.SetAttributeValue("Att2", 22);
Console.WriteLine(root);

// Remove one of the name/value pairs.
root.SetAttributeValue("Att3", null);
Console.WriteLine(root);
' Create an element with no content.
Dim root As XElement = <Root/>

' Add some name/value pairs.
root.SetAttributeValue("Att1", 1)
root.SetAttributeValue("Att2", 2)
root.SetAttributeValue("Att3", 3)
Console.WriteLine(root)

' Modify one of the name/value pairs.
root.SetAttributeValue("Att2", 22)
Console.WriteLine(root)

' Remove one of the name/value pairs.
root.SetAttributeValue("Att3", Nothing)
Console.WriteLine(root)

Cet exemple produit la sortie suivante :

<Root Att1="1" Att2="2" Att3="3" />
<Root Att1="1" Att2="22" Att3="3" />
<Root Att1="1" Att2="22" />

Remarques

Cette méthode est conçue pour faciliter la gestion d’une liste de paires nom/valeur en tant qu’ensemble d’attributs. Lors de la maintenance de la liste, vous devez ajouter des paires, modifier des paires ou supprimer des paires. Si vous appelez cette méthode en passant un nom qui n’existe pas en tant qu’attribut, cette méthode crée un attribut pour vous. Si vous appelez cette méthode en passant le nom d’un attribut existant, cette méthode modifie la valeur de l’attribut en la valeur que vous spécifiez. Si vous passez null pour value, cette méthode supprime l’attribut .

Cette méthode déclenche les Changed événements et .Changing

La valeur est affectée à l’attribut avec le nom spécifié. S’il n’existe aucun attribut portant le nom spécifié, un nouvel attribut est ajouté. Si la valeur est null, l’attribut portant le nom spécifié, le cas échéant, est supprimé.

Pour plus d’informations, consultez Gérer les paires nom-valeur.

S’applique à

Voir aussi