XElement.SetElementValue(XName, Object) Methode

Definition

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Source:

XElement.cs

Legt den Wert eines untergeordneten Elements fest, fügt ein untergeordnetes Element hinzu oder entfernt ein untergeordnetes Element.

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)

Parameter

name

XName

Ein XName, der den Namen des untergeordneten Elements enthält, das geändert werden soll.

value

Object

Der dem untergeordneten Element zuzuweisende Wert. Das untergeordnete Element wird entfernt, wenn der Wert nullist. Andernfalls wird der Wert in seine Zeichenfolgenentsprechung konvertiert und der Value-Eigenschaft des untergeordneten Elements zugewiesen.

Ausnahmen

ArgumentException

Der value ist eine Instanz von XObject

Beispiele

Im folgenden Beispiel wird ein Element mit einem untergeordneten Element erstellt. Anschließend wird diese Methode verwendet, um den Wert des untergeordneten Elements festzulegen.

// 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)

Dieses Beispiel erzeugt die folgende Ausgabe:

<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>

Hinweise

Diese Methode wurde entwickelt, um das Verwalten einer Liste von Namen-Wert-Paaren als Satz untergeordneter Elemente zu vereinfachen. Beim Verwalten der Liste müssen Sie Paare hinzufügen, Paare ändern oder Paare löschen. Wenn Sie diese Methode aufrufen und einen Namen übergeben, der nicht als untergeordnetes Element vorhanden ist, erstellt diese Methode ein untergeordnetes Element für Sie. Wenn Sie diese Methode aufrufen und den Namen eines vorhandenen untergeordneten Elements übergeben, ändert diese Methode den Wert des untergeordneten Elements in den von Ihnen angegebenen Wert. Wenn Sie für valueübergebennull, entfernt diese Methode das untergeordnete Element.

Diese Methode löst Ereignisse aus.

Der Wert wird dem ersten untergeordneten Element mit dem angegebenen Namen zugewiesen. Wenn kein untergeordnetes Element mit dem angegebenen Namen vorhanden ist, wird ein neues untergeordnetes Element hinzugefügt. Wenn der Wert NULL ist, wird das erste untergeordnete Element mit dem angegebenen Namen gelöscht, falls vorhanden.

Diese Methode fügt dem angegebenen untergeordneten Element keine untergeordneten Knoten oder Attribute hinzu. Diese Methode löst eine Ausnahme aus, wenn jedes Objekt, das von XObject abgeleitet wird, als valueübergeben wird.

Weitere Informationen finden Sie unter Verwalten von Name-Wert-Paaren.

Weitere Informationen

• SetValue(Object)
• SetElementValue(XName, Object)
• SetValue(Object)
• Übersicht über LINQ to XML
• Verwalten von Name-Wert-Paaren