XamlServices::Parse Method (String^)
Reads XAML as string output and returns an object graph.
Assembly: System.Xaml (in System.Xaml.dll)
Parameters
- xaml
-
Type:
System::String^
The XAML string input to parse.
| 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.
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. |
Available since 4.0
