Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método DependencyObject.ClearValue (DependencyProperty)

 

Publicado: octubre de 2016

Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty.

Espacio de nombres:   System.Windows
Ensamblado:  WindowsBase (en WindowsBase.dll)

public void ClearValue(
	DependencyProperty dp
)

Parámetros

dp
Type: System.Windows.DependencyProperty

Propiedad de dependencia que se va a borrar, identificada con una referencia de objeto DependencyProperty.

Exception Condition
InvalidOperationException

Se intentó llamar a ClearValue en un DependencyObject sellado.

Clearing the property value by calling M:System.Windows.DependencyObject.ClearValue(System.Windows.DependencyProperty) does not necessarily give a dependency property the default value that is specified in the dependency property metadata. Clearing the property only specifically clears whatever local value may have been applied. For more information, see Dependency Property Value Precedence.

The following example iterates all properties that have local values set on an object, then calls M:System.Windows.DependencyObject.ClearValue(System.Windows.DependencyProperty) to clear the values of each such property.

void RestoreDefaultProperties(object sender, RoutedEventArgs e)
{
    UIElementCollection uic = Sandbox.Children;
    foreach (Shape uie in uic)
    {
        LocalValueEnumerator locallySetProperties = uie.GetLocalValueEnumerator();
        while (locallySetProperties.MoveNext())
        {
            DependencyProperty propertyToClear = locallySetProperties.Current.Property;
            if (!propertyToClear.ReadOnly) { uie.ClearValue(propertyToClear); }
        }
    }
}

.NET Framework
Disponible desde 3.0
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Volver al principio
Mostrar: