XElement.Load Method (String)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Loads an XElement from a file located in the applications' XAP package.

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

Syntax

'Declaration
Public Shared Function Load ( _
    uri As String _
) As XElement
public static XElement Load(
    string uri
)

Parameters

  • uri
    Type: System.String
    A URI string that references the file to be loaded into a new XElement. This file is located in the application's XAP package. If you want to download a file from some other location, follow the steps described in How to: Load an XML file from an Arbitrary URI Location with LINQ to XML.

Return Value

Type: System.Xml.Linq.XElement
An XElement that contains the contents of the specified file.

Remarks

This method reads the XML into the XML tree. It discards all insignificant white space in the file. If you want to control load options, use the Load overload 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.

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.

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

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.