This documentation is archived and is not being maintained.

XamlType.IsUsableDuringInitialization Property

Gets a value that indicates whether this XamlType is built top-down during XAML initialization.

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

public bool IsUsableDuringInitialization { get; }

Property Value

Type: System.Boolean
true if this XamlType is built top-down during XAML initialization; otherwise, false. The default is false.

Top-down is a metaphor that approximates XAML processor behavior when creating the object graph. When built top-down, a type is instantiated, attached to the parent, and then has its properties set. Top-down construction avoids invoking property-changed handlers multiple times. Such handling ripples up the object graph and therefore, eliminates the multiple handler calls and provides a performance optimization for startup of the object graph.

If you do not use the default internal CLR reflection technique for a XamlType, calls to this property can invoke LookupUsableDuringInitialization overrides on XamlType derived classes. For more information about return values and other behavior, see the documentation for LookupUsableDuringInitialization on this type.

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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