Auf Englisch lesen

Freigeben über


XElement.SetValue(Object) Methode

Definition

Legt den Wert dieses Elements fest.

C#
public void SetValue(object value);

Parameter

value
Object

Der diesem Element zuzuweisende Wert. Der Wert wird in seine Zeichenfolgenentsprechung konvertiert und der Value-Eigenschaft zugewiesen.

Ausnahmen

value ist null.

Der value ist ein XObject.

Beispiele

Im folgenden Beispiel wird ein Element erstellt, das ein untergeordnetes Element enthält. Anschließend wird der Wert des Elements mithilfe dieser Methode festgelegt.

C#
XElement root = new XElement("Root",
    new XElement("Child", "child content")
);
root.SetValue("new content");
Console.WriteLine(root);

Dieses Beispiel erzeugt die folgende Ausgabe:

XML
<Root>new content</Root>

Hinweise

Diese Methode löst die Changed Ereignisse und aus Changing .

Es ist ungültig, eine instance einer Klasse zu übergeben, die von XObjectabgeleitet wird, z. BXElement. .

Gilt für:

Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Weitere Informationen