XamlServices.Load Method (String)

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
)

Parameters

fileName
Type: System.String

The file name to load and use as source.

Return Value

Type: System.Object
The object graph that is returned.

ExceptionCondition
ArgumentNullException

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

Supported in: 4.6, 4.5, 4

.NET Framework Client Profile

Supported in: 4
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft