DependencyPropertyHelper Class

 
System_CAPS_noteNote

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

Provides a single helper method (GetValueSource) that reports the property system source for the effective value of a dependency property.

Namespace:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

System.Object
  System.Windows.DependencyPropertyHelper

[<AbstractClass>]
[<Sealed>]
type DependencyPropertyHelper = class end

NameDescription
System_CAPS_pubmethodSystem_CAPS_staticGetValueSource(DependencyObject, DependencyProperty)

Returns a structure that reports various metadata and property system characteristics of a specified dependency property on a particular DependencyObject.

System_CAPS_pubmethodSystem_CAPS_staticIsTemplatedValueDynamic(DependencyObject, DependencyProperty)

Indicates whether a specified element belongs to an instance of a template that defines a value for the specified property that may change at runtime based on changes elsewhere.

TheWPF property system is fairly complex, and relies on rationalizing the values that potentially come from a variety of inputs, based on an established value determination precedence. Because these sources potentially come from run-time code, from compiled markup, or even from run-time user settings, it can be useful to know exactly which participant in the dependency property value system established the value you obtain when calling GetValue at run-time on that property. If the value came from a different source than you had intended, you might need to adjust some aspect of your application. The value source might be a style, a theme, a local value, an animation, a binding, or a run-time based value such as system settings through themes or system resources. For more information, see Dependency Property Value Precedence.

Another mechanism that reports on the property in general, rather than a specific instance of the property on an object, is the property metadata. The property metadata is findable by calling GetMetadata and examining the returned PropertyMetadata (or one of several possible derived classes that the returned property metadata is castable to).

.NET Framework
Available since 3.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: