This topic has not yet been rated - Rate this topic

XElement.Load Method (TextReader)

.NET Framework 4

Other Versions

Loads an XElement from a TextReader.

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

Syntax

C++

Copy

public static XElement Load(
	TextReader textReader
)

Parameters

textReader: Type: System.IO.TextReader
A TextReader that will be read for the XElement content.

Return Value

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

Remarks

This method reads the raw XML into the XML tree. It discards all insignificant white space in the file.

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 loads an element from a StringReader.

Copy

TextReader sr = new StringReader("<Root><Child/></Root>");
XElement xmlTree = XElement.Load(sr);
sr.Close();
Console.WriteLine(xmlTree);

This example produces the following output:

xmlLang

Copy

<Root>
  <Child />
</Root>

Version Information

.NET Framework

Supported in: 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

XElement Class

Load Overload

System.Xml.Linq Namespace

Other Resources

LINQ to XML

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ