XElement.SetValue(Object) Method

Definition

Sets the value of this element.

public void SetValue (object value);

Parameters

value
Object

The value to assign to this element. The value is converted to its string representation and assigned to the Value property.

Exceptions

The value is null.

The value is an XObject.

Examples

The following example creates an element that contains a child element. It then sets the value of the element using this method.

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

This example produces the following output:

<Root>new content</Root>

Remarks

This method will raise the Changed and the Changing events.

It is invalid to pass an instance of a class that derives from XObject, such as XElement.

Applies to

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

See also