.NET Framework Class Library
XElement.SetValue Method
Sets the value of this element.
Assembly: System.Xml.Linq (in System.Xml.Linq.dll)
Syntax
Visual Basic
Public Sub SetValue ( _ value As Object _ )
C#
public void SetValue( Object value )
Visual C++
public: void SetValue( Object^ value )
F#
member SetValue : value:Object -> unit
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 null. |
| 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.
C#
XElement root = new XElement("Root", new XElement("Child", "child content") ); root.SetValue("new content"); Console.WriteLine(root);
Visual Basic
Dim root As XElement = _ <Root> <Child>child content</Child> </Root> root.SetValue("new content") Console.WriteLine(root)
This example produces the following output:
xmlLang
<Root>new content</Root>
Version Information
.NET Framework
Supported in: 4, 3.5.NET Framework Client Profile
Supported in: 4, 3.5 SP1Platforms
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
See Also
Reference
SetValue