Export (0) Print
Expand All

XElement.SetValue Method

Sets the value of this element.

Namespace:  System.Xml.Linq
Assemblies:   System.Xml.Linq (in System.Xml.Linq.dll)
  System.Xml.XDocument (in System.Xml.XDocument.dll)

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

ExceptionCondition
ArgumentNullException

The value is Nothing.

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>

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft