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

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.