Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

DependencyObject.ClearValue (Método) (DependencyProperty)

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

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

public void ClearValue(
	DependencyProperty dp
)

Parámetros

dp
Tipo: System.Windows.DependencyProperty
Propiedad de dependencia que se va a borrar, identificada por una referencia a objeto DependencyProperty.

ExcepciónCondición
InvalidOperationException

Se intentó llamar a ClearValue en un objeto DependencyObject sellado.

Borrar el valor de la propiedad llamando a ClearValue no asigna necesariamente a una propiedad de dependencia el valor predeterminado que se especifica en los metadatos de propiedad de dependencia. Al borrar la propiedad sólo se borra específicamente cualquier valor local que se haya aplicado. Para obtener más información, vea Prioridad de los valores de propiedades de dependencia.

El ejemplo siguiente itera todas las propiedades que tienen valores locales establecidos en un objeto, a continuación, llama a ClearValue para borrar los valores de cada una de esas propiedades.


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

Compatible con: 4, 3.5, 3.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.
Mostrar: