Export (0) Print
Expand All

DependencyObject::GetValue Method

Returns the current effective value of a dependency property on this instance of a DependencyObject.

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

public:
Object^ GetValue(
	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 current effective value.

ExceptionCondition
InvalidOperationException

The specified dp or its value was invalid, or the specified dp does not exist.

The effective value is the value of the property that is returned by the property system to any caller that is requesting the value. The effective value is the result of the property system having evaluated all the possible inputs that participate in the property system value precedence. This includes coercion and animation. For more information, see Dependency Property Value Precedence.

This method will never return UnsetValue. The UnsetValue is a sentinel value for the property system that is used in various capacities internally and occasionally also exposed through coercion callbacks.

If you are not sure what the property's type should be, you can query the identifier of the requested dependency property to determine whether there is a more specific PropertyType that the return value can be converted to.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft