XDocument.Load Method (TextReader, LoadOptions)

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Creates a new XDocument from a TextReader, optionally preserving white space, setting the base URI, and retaining line information.

Namespace: System.Xml.Linq
Assembly: System.Xml.Linq (in System.Xml.Linq.dll)

Syntax

Public Shared Function Load ( _
    textReader As TextReader, _
    options As LoadOptions _
) As XDocument
public static XDocument Load(
    TextReader textReader,
    LoadOptions options
)

Parameters

Return Value

Type: System.Xml.Linq..::.XDocument
An XDocument that contains the XML that was read from the specified TextReader.

Remarks

If the source XML is indented, setting the PreserveWhitespace flag in options causes the reader to read all white space in the source XML. Nodes of type XText are created for both significant and insignificant white space.

If the source XML is indented, not setting the PreserveWhitespace flag in options causes the reader to ignore all of the insignificant white space in the source XML. The XML tree is created without any text nodes for insignificant white space.

If the source XML is not indented, setting the PreserveWhitespace flag in options has no effect. Significant white space is still preserved, and there are no spans of insignificant white space that could cause the creation of more white space text nodes.

Use Parse to create an XDocument from a string that contains XML.

Setting SetBaseUri is not valid when loading from a TextReader.

There is a performance penalty if you set the SetLineInfo flag.

The line information is accurate immediately after loading the XML document. If you modify the XML tree after loading the document, the line information may become meaningless.

Examples

The following example creates a document from a StringReader.

Dim output As New StringBuilder
Dim sr As TextReader
Dim whiteSpaceNodes As Integer

sr = New StringReader("<Root> <Child> </Child> </Root>")
Dim xmlTree1 As XDocument = XDocument.Load(sr, LoadOptions.None)
sr.Close()
whiteSpaceNodes = xmlTree1 _
              .Element("Root") _
              .DescendantNodesAndSelf() _
              .OfType(Of XText)() _
              .Where(Function(tNode As XNode) tNode. _
                  ToString().Trim().Length = 0).Count()
output.Append("Count of white space nodes (not preserving whitespace): {0}", whiteSpaceNodes)
output.Append(Environment.NewLine)
sr = New StringReader("<Root> <Child> </Child> </Root>")
Dim xmlTree2 As XDocument = XDocument.Load(sr, LoadOptions.PreserveWhitespace)
sr.Close()
whiteSpaceNodes = xmlTree2 _
              .Element("Root") _
              .DescendantNodesAndSelf() _
              .OfType(Of XText)() _
              .Where(Function(tNode As XNode) tNode. _
                  ToString().Trim().Length = 0).Count()
output.Append("Count of white space nodes (preserving whitespace): {0}", whiteSpaceNodes)
output.Append(Environment.NewLine)

OutputTextBlock.Text = output.ToString()
StringBuilder output = new StringBuilder();
TextReader sr;
int whiteSpaceNodes;

sr = new StringReader("<Root> <Child> </Child> </Root>");
XDocument xmlTree1 = XDocument.Load(sr, LoadOptions.None);
sr.Close();
whiteSpaceNodes = xmlTree1
    .Element("Root")
    .DescendantNodesAndSelf()
    .OfType<XText>()
    .Where(tNode => tNode.ToString().Trim().Length == 0)
    .Count();
output.Append("Count of white space nodes (not preserving whitespace): " + whiteSpaceNodes);
output.Append(Environment.NewLine);

sr = new StringReader("<Root> <Child> </Child> </Root>");
XDocument xmlTree2 = XDocument.Load(sr, LoadOptions.PreserveWhitespace);
sr.Close();
whiteSpaceNodes = xmlTree2
    .Element("Root")
    .DescendantNodesAndSelf()
    .OfType<XText>()
    .Where(tNode => tNode.ToString().Trim().Length == 0)
    .Count();
output.Append("Count of white space nodes (preserving whitespace): " + whiteSpaceNodes);
output.Append(Environment.NewLine);

OutputTextBlock.Text = output.ToString();

Version Information

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Platforms

Windows Phone

See Also

Reference

XDocument Class

Load Overload

System.Xml.Linq Namespace

Parse

Save

WriteTo