XElement.Value Property (System.Xml.Linq)

Switch View :
ScriptFree
.NET Framework Class Library
XElement.Value Property

Gets or sets the concatenated text contents of this element.

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

Visual Basic
Public Property Value As String
	Get
	Set
C#
public string Value { get; set; }
Visual C++
public:
property String^ Value {
	String^ get ();
	void set (String^ value);
}
F#
member Value : string with get, set

Property Value

Type: System.String
A String that contains all of the text content of this element. If there are multiple text nodes, they will be concatenated.
Remarks

Using this property, you can get or set the value of an element.

Setting this property will raise the Changed and the Changing events.

If you want to get the value of an element but you are not sure that it exists, it is more convenient to use the explicit conversion operators, and assign the element to a nullable type such as string or Nullable<T> of Int32. If the element does not exist, the nullable type is set to null. By contrast, if you want to use this property, you must make sure that the Element method does not return null before you access this property.

Examples

The following example uses this property to retrieve the text of an element with mixed content.

C#
XElement el = XElement.Parse("<Root>This is <b>mixed</b> content</Root>");
Console.WriteLine("{0}", el.Value);
Visual Basic
Dim el As XElement = <Root>This is <b>mixed</b> content</Root>
Console.WriteLine("{0}", el.Value)

This example produces the following output:

This is mixed content
Version Information

.NET Framework

Supported in: 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Platforms

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

Other Resources