XElement.SetValue Method (Object)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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
)

Parameters

value
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
ArgumentNullException

The value is null.

ArgumentException

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 = _ 
        <Root>
            <Child>child content</Child>
        </Root>

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

This example produces the following output:


<Root>new content</Root>

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