XElement.Value Property
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Gets the concatenated text contents of this element.
Namespace: System.Xml.Linq
Assembly: System.Xml.Linq (in System.Xml.Linq.dll)
Syntax
'Declaration
Public Property Value As String
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.
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 nulla null reference (Nothing in Visual Basic). By contrast, if you want to use this property, you must make sure that the Element method does not return nulla null reference (Nothing in Visual Basic) before you access this property.
Examples
The following example uses this property to retrieve the text of an element with mixed content.
Dim output As New StringBuilder
Dim el As XElement = <Root>This is <b>mixed</b> content</Root>
output.Append(String.Format("{0}", el.Value))
output.Append(Environment.NewLine)
OutputTextBlock.Text = output.ToString()
StringBuilder output = new StringBuilder();
XElement el = XElement.Parse("<Root>This is <b>mixed</b> content</Root>");
output.Append(el.Value + 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.
See Also