SetValue Method

XElement.SetValue Method (Object)


Sets the value of this element.

Namespace:   System.Xml.Linq
Assembly:  System.Xml.Linq (in System.Xml.Linq.dll)

Public Sub SetValue (
	value As Object


Type: System.Object

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

Exception Condition

The value is null.


The value is an XObject.

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.

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

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

root.SetValue("new content")

This example produces the following output:

<Root>new content</Root>

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 3.5
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
© 2015 Microsoft