XamlLanguage.SynchronousMode Property

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets a XamlDirective that enables loading XAML asynchronously if the XAML processor supports such a mode.

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

public static XamlDirective SynchronousMode { get; }

Property Value

Type: System.Xaml.XamlDirective

A XamlDirective that enables loading XAML asynchronously.

A SynchronousMode directive (when set to Async) is used to specify that when a XAML file is loaded, the root node is processed first. The resulting object can be inserted even though its content is still processing. In this mode you can bypass the default XAML processing behavior of working from deepest node to the root. In the default processing logic for XAML, any caller that is waiting for the root object is blocked until the full parse is complete. SynchronousMode is not specified in [MS-XAML] but is part of the x namespace–defined behavior for XAML in WPF beginning in .NET Framework version 3.5 with SP1 (or any subsequent service pack).

.NET Framework
Available since 4.0
Return to top