Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

DependencyObject::ReadLocalValue Method (DependencyProperty^)

 

Returns the local value of a dependency property, if it exists.

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

public:
Object^ ReadLocalValue(
	DependencyProperty^ dp
)

Parameters

dp
Type: System.Windows::DependencyProperty^

The DependencyProperty identifier of the property to retrieve the value for.

Return Value

Type: System::Object^

Returns the local value, or returns the sentinel value UnsetValue if no local value is set.

You should use GetValue for most typical "get" operations for a dependency property. ReadLocalValue does not return the effective value for a variety of circumstances where the value was not locally set.

Values that are set by styles, themes, templates, the default value from metadata, or property value inheritance are not considered to be local values. However, bindings and other expressions are considered to be local values, after they have been evaluated.

When no local value is set, this method returns UnsetValue.

If the returned value is other than UnsetValue, you can query the metadata of the requested dependency property to determine whether there is a more specific type that the return value can be converted to.

.NET Framework
Available since 3.0
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Return to top
Show:
© 2016 Microsoft