Export (0) Print
Expand All

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)

public string Value { 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.

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.

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

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

This example produces the following output:

This is mixed content

.NET Framework

Supported in: 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

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.

Community Additions

ADD
Show:
© 2014 Microsoft