XamlServices.Parse(String) Method

Definition

Namespace:

System.Xaml

Assembly:

System.Xaml.dll

Reads XAML as string output and returns an object graph.

public:
 static System::Object ^ Parse(System::String ^ xaml);

public static object Parse (string xaml);

static member Parse : string -> obj

Public Shared Function Parse (xaml As String) As Object

Parameters

xaml

String

The XAML string input to parse.

Returns

Object

The object graph that is returned.

Exceptions

ArgumentNullException

xaml input is null.

Remarks

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.

Important

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.