Export (0) Print
Expand All

XElement.Value Property

Gets or sets the concatenated text contents of this element.

Namespace:  System.Xml.Linq
Assemblies:   System.Xml.XDocument (in System.Xml.XDocument.dll)
  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.6, 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft