• Article

XElement.SetValue Method

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Sets the value of this element.

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

Syntax

'Declaration
Public Sub SetValue ( _
    value As Object _
)

public void SetValue(
    Object value
)

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.

Exceptions

Exception Condition
ArgumentNullException

The value is nulla null reference (Nothing in Visual Basic).
ArgumentException

The value is an XObject.

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.

Examples

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

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

root.SetValue("new content")
output.Append(root)
output.Append(Environment.NewLine)

OutputTextBlock.Text = output.ToString()

StringBuilder output = new StringBuilder();
XElement root = new XElement("Root",
    new XElement("Child", "child content")
);
root.SetValue("new content");
output.Append(root + Environment.NewLine);

OutputTextBlock.Text = output.ToString();

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.