XamlServices.Parse(String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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 -> objPublic Shared Function Parse (xaml As String) As ObjectParameters
- xaml
- String
The XAML string input to parse.
Returns
The object graph that is returned.
Exceptions
xaml input is null.
Remarks
In order for the Parse call to successfully create an object tree, the following must be true:
The
xamlinput is well-formed and valid XML.The
xamlinput is valid XAML at the language level.The XAML types that are specified in the
xamlinput 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.
