XElement.SetElementValue(XName, Object) Methode

Definition

Namespace:
System.Xml.Linq
Assemblys:
System.Xml.Linq.dll, System.Xml.XDocument.dll
Assemblys:
netstandard.dll, System.Xml.XDocument.dll
Assembly:
System.Xml.XDocument.dll
Assembly:
System.Xml.Linq.dll
Assembly:
netstandard.dll
Quelle:
XElement.cs
Quelle:
XElement.cs
Quelle:
XElement.cs
Quelle:
XElement.cs
Quelle:
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);
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 Element, das den Namen des zu ändernden untergeordneten Elements enthält.

value
Object

Der Wert, der dem untergeordneten Element zugewiesen werden soll. Das untergeordnete Element wird entfernt, wenn der Wert ist null. Andernfalls wird der Wert in seine Zeichenfolgendarstellung konvertiert und der Value Eigenschaft des untergeordneten Elements zugewiesen.

Ausnahmen

ArgumentException

Dies 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 ist so konzipiert, dass eine Liste mit Namen-Wert-Paaren als Gruppe untergeordneter Elemente leicht verwaltet werden kann. Beim Verwalten der Liste müssen Sie Paare hinzufügen, Paare ändern oder Paare löschen. Wenn Sie diese Methode aufrufen, die einen Namen übergibt, der nicht als untergeordnetes Element vorhanden ist, erstellt diese Methode ein untergeordnetes Element für Sie. Wenn Sie diese Methode aufrufen, die den Namen eines vorhandenen untergeordneten Elements übergibt, ändert diese Methode den Wert des untergeordneten Elements in den von Ihnen angegebenen Wert. Wenn Sie diese Methode übergeben nullvalue, wird das untergeordnete Element entfernt.

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 (falls vorhanden) gelöscht.

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

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

Gilt für:

Weitere Informationen