Load Method (Stream, LoadOptions)

XElement.Load Method (Stream, LoadOptions)


Creates a new XElement instance by 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 static XElement Load(
	Stream stream,
	LoadOptions options


Type: System.IO.Stream

The stream containing the XML data.

Type: System.Xml.Linq.LoadOptions

A LoadOptions object that specifies whether to load base URI and line information.

Return Value

Type: System.Xml.Linq.XElement

An XElement object used to read the data that the stream contains.

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 XElement's Load overloads that takes XmlReader as a parameter.

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 4.0
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
© 2015 Microsoft