XDocument.Load Method (Stream, LoadOptions)

Creates a new XDocument instance using the specified stream, 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)


Public Shared Function Load ( _
    stream As Stream, _
    options As LoadOptions _
) As XDocument
public static XDocument Load(
    Stream stream,
    LoadOptions options


Return Value

Type: System.Xml.Linq.XDocument
An XDocument object used to read the data contained in the stream.


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.

If you have to modify XmlReaderSettings, following these steps:

  1. Create an XmlReader by calling one of the Create overloads that take XmlReaderSettings as a parameter.

  2. Pass the XmlReader to one of the XDocument's Load overloads that takes XmlReader as a parameter.

For code examples, see:

How to: Load an XML File from an Arbitrary URI Location with LINQ to XML

How to: Save to and Load from Isolated Storage with LINQ to XML

How to: Load a File from a XAP Package Using XmlXapResolver

You can find more examples under Processing XML Data with LINQ to XML (Silverlight).

Version Information


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


For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.