XElement.SetValue(Object) Methode

Definition

Namespace:

System.Xml.Linq

Assembly:

System.Xml.XDocument.dll

Source:

XElement.cs

Legt den Wert dieses Elements fest.

public:
 void SetValue(System::Object ^ value);

public void SetValue (object value);

member this.SetValue : obj -> unit

Public Sub SetValue (value As Object)

Parameter

value

Object

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

Ausnahmen

ArgumentNullException

value ist null.

ArgumentException

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.

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

Dim root As XElement = _
        <Root>
            <Child>child content</Child>
        </Root>

root.SetValue("new content")
Console.WriteLine(root)

Dieses Beispiel erzeugt die folgende Ausgabe:

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

Weitere Informationen

• SetValue(Object)
• SetAttributeValue(XName, Object)
• SetValue(Object)
• Übersicht über LINQ to XML