Application.LoadComponent Method (Uri)

 

Loads a XAML file that is located at the specified uniform resource identifier (URI), and converts it to an instance of the object that is specified by the root element of the XAML file.

Namespace:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

public static object LoadComponent(
	Uri resourceLocator
)

Parameters

resourceLocator
Type: System.Uri

A Uri that maps to a relative XAML file.

Return Value

Type: System.Object

An instance of the root element specified by the XAML file loaded.

Exception Condition
ArgumentNullException

resourceLocator is null.

ArgumentException

The OriginalString property of the resourceLocatorUri parameter is null.

ArgumentException

The resourceLocator is an absolute URI.

Exception

The file is not a XAML file.

You must explicitly convert the return value to the same type as the root element of the XAML file.

The XAML file can be an application code file (configured as an Microsoft build engine (MSBuild) Page item) or an application data file (a resource file, content file, or site-of-origin file; see WPF Application Resource, Content, and Data Files).

System_CAPS_noteNote

This method is not thread-safe.

.NET Framework
Available since 3.0
Return to top
Show: