XElement.SetElementValue(XName, Object) Méthode

Définition

Espace de noms:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Source:

XElement.cs

Définit la valeur d'un élément enfant, ajoute un élément enfant ou supprime un élément enfant.

public:
 void SetElementValue(System::Xml::Linq::XName ^ name, System::Object ^ value);

public void SetElementValue (System.Xml.Linq.XName name, object? value);

member this.SetElementValue : System.Xml.Linq.XName * obj -> unit

Public Sub SetElementValue (name As XName, value As Object)

Paramètres

name

XName

XName qui contient le nom de l'élément enfant à modifier.

value

Object

Valeur à assigner à l'élément enfant. L'élément enfant 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'élément enfant.

Exceptions

ArgumentException

La value est une instance de XObject.

Exemples

L’exemple suivant crée un élément avec un élément enfant. Il utilise ensuite cette méthode pour définir la valeur de l’élément enfant.

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

// Add some name/value pairs.
root.SetElementValue("Ele1", 1);
root.SetElementValue("Ele2", 2);
root.SetElementValue("Ele3", 3);
Console.WriteLine(root);

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

// Remove one of the name/value pairs.
root.SetElementValue("Ele3", null);
Console.WriteLine(root);

' Create an element with no content.
Dim root As XElement = <Root/>

' Add some name/value pairs.
root.SetElementValue("Ele1", 1)
root.SetElementValue("Ele2", 2)
root.SetElementValue("Ele3", 3)
Console.WriteLine(root)

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

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

Cet exemple produit la sortie suivante :

<Root>
  <Ele1>1</Ele1>
  <Ele2>2</Ele2>
  <Ele3>3</Ele3>
</Root>
<Root>
  <Ele1>1</Ele1>
  <Ele2>22</Ele2>
  <Ele3>3</Ele3>
</Root>
<Root>
  <Ele1>1</Ele1>
  <Ele2>22</Ele2>
</Root>

Remarques

Cette méthode est conçue pour faciliter la gestion d’une liste de paires nom/valeur en tant qu’ensemble d’éléments enfants. 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’élément enfant, cette méthode crée un élément enfant pour vous. Si vous appelez cette méthode en passant le nom d’un élément enfant existant, cette méthode modifie la valeur de l’élément enfant en la valeur que vous spécifiez. Si vous passez null pour value, cette méthode supprime l’élément enfant.

Cette méthode déclenche des événements.

La valeur est affectée au premier élément enfant avec le nom spécifié. Si aucun élément enfant portant le nom spécifié n’existe, un nouvel élément enfant est ajouté. Si la valeur est null, le premier élément enfant portant le nom spécifié, le cas échéant, est supprimé.

Cette méthode n’ajoute pas de nœuds ou d’attributs enfants à l’élément enfant spécifié. Cette méthode lève une exception si un objet qui dérive de XObject est passé en tant que value.

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

Voir aussi

• SetValue(Object)
• SetElementValue(XName, Object)
• SetValue(Object)
• Vue d’ensemble de LINQ to XML
• Conserver des paires nom-valeur