XamlServices.Load Method (String)

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Loads a Stream source for a XAML reader and returns an object graph.

Namespace:   System.Xaml
Assembly:  System.Xaml (in System.Xaml.dll)

public static object Load(
	string fileName


Type: System.String

The file name to load and use as source.

Return Value

Type: System.Object

The object graph that is returned.

Exception Condition

fileName input is null.

Different signatures for the Load method specify different types of input for the source XAML. The Load internal implementation first creates an XmlReader by calling Create(String) and then creates a new instance of a specialized XamlReader that processes the input.

In order for the Load(String) call to successfully create an object graph, the following must be true:

  • The source is well-formed and valid XML.

  • The source is valid XAML at the language level.

  • The XAML types that are specified in the source XAML must resolve to backing types in the relevant XAML namespaces. For example, XAML types for WPF namespaces can resolve to a WPF XAML namespace as specified in the XAML; the assemblies for WPF must be included in the project or be available in the run time; and so on.

.NET Framework
Available since 4.0
Return to top