XamlServices.Parse Method (String)

.NET Framework (current version)
 

Reads XAML as string output and returns an object graph.

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

public static object Parse(
	string xaml
)

Parameters

xaml
Type: System.String

The XAML string input to parse.

Return Value

Type: System.Object

The object graph that is returned.

Exception Condition
ArgumentNullException

xaml input is null.

In order for the Parse call to successfully create an object tree, the following must be true:

  • The xaml input is well-formed and valid XML.

  • The xaml input is valid XAML at the language level.

  • The XAML types that are specified in the xaml input must resolve to backing types in the relevant XAML namespaces. For example, XAML types for a WPF namespace 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.

System_CAPS_importantImportant

XamlServices is not the recommended XAML reading or XAML writing API set if you are processing Windows Presentation Foundation (WPF) types, or types based on WPF. For WPF usage, use System.Windows.Markup.XamlReader for reading or loading XAML, and System.Windows.Markup.XamlWriter for writing back XAML. These classes use System.Xaml APIs internally in their implementation; however, they also provide support for WPF-specific concepts that influence the nature of XAML reading and writing, such as optimizations for dependency properties.

.NET Framework
Available since 4.0
Return to top
Show: