ClearValue Method
Collapse the table of content
Expand the table of content

DependencyObject.ClearValue Method

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Clears the local value of a dependency property.

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

public void ClearValue(
	DependencyProperty dp


Type: System.Windows.DependencyProperty
The DependencyProperty identifier of the property to clear the value for.

Clearing the property value by calling ClearValue does not necessarily give a dependency property its default value. Clearing the property only specifically clears whatever local value may have been applied, but other factors in dependency property precedence (such as styles, or an animation) might still be applying a value.

The following example checks for an existing local value with ReadLocalValue. If there is a local value, as indicated by not returning UnsetValue, then the existing local value is removed by calling ClearValue.

public static bool ClearSetProperty(DependencyObject targetObject, DependencyProperty targetDP)
    if (targetObject == null || targetDP == null)
        throw new ArgumentNullException();
    object localValue = targetObject.ReadLocalValue(targetDP);
    if (localValue == DependencyProperty.UnsetValue)
        return false;
        return true;

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

© 2018 Microsoft