Export (0) Print
Expand All

XamlServices.Parse Method

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.

ExceptionCondition
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.

Important noteImportant

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

Supported in: 4.5, 4

.NET Framework Client Profile

Supported in: 4

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft