XDocument.Parse Method (String)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Creates a new XDocument from a string.
Namespace: System.Xml.Linq
Assembly: System.Xml.Linq (in System.Xml.Linq.dll)
Syntax
'Declaration
Public Shared Function Parse ( _
text As String _
) As XDocument
public static XDocument Parse(
string text
)
Parameters
- text
Type: System.String
A string that contains XML.
Return Value
Type: System.Xml.Linq.XDocument
An XDocument populated from the string that contains XML.
Remarks
This method does not preserve white space. If you want to preserve white space in the XML tree, use the overload of Parse that takes LoadOptions as a parameter.
LINQ to XML's loading functionality is built upon XmlReader. Therefore, you might catch any exceptions that are thrown by the XmlReader.Create overload methods and the XmlReader methods that read and parse the document.
Examples
The following example creates a string that contains XML. It then parses the string into an XDocument.
Dim output As New StringBuilder
Dim str As String = _
"<?xml version= '1.0'?>" & _
"<!-- comment at the root level -->" & _
"<Root>" & _
" <Child>Content</Child>" & _
"</Root>"
Dim doc As XDocument = XDocument.Parse(str)
output.Append(doc)
output.Append(Environment.NewLine)
OutputTextBlock.Text = output.ToString()
StringBuilder output = new StringBuilder();
string str =
@"<?xml version=""1.0""?>
<!-- comment at the root level -->
<Root>
<Child>Content</Child>
</Root>";
XDocument doc = XDocument.Parse(str);
output.Append(doc + 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