DependencyObject.ClearValue Método

Definición

Espacio de nombres:

System.Windows

Ensamblado:

WindowsBase.dll

Borra el valor local de una propiedad.

Sobrecargas

ClearValue(DependencyProperty)	Borra el valor local de una propiedad. La propiedad que se va a borrar se especifica mediante un identificador DependencyProperty.
ClearValue(DependencyPropertyKey)	Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey.

ClearValue(DependencyProperty)

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

public:
 void ClearValue(System::Windows::DependencyProperty ^ dp);

public void ClearValue (System.Windows.DependencyProperty dp);

member this.ClearValue : System.Windows.DependencyProperty -> unit

Public Sub ClearValue (dp As DependencyProperty)

Parámetros

dp

DependencyProperty

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

Excepciones

InvalidOperationException

Se intentó llamar a ClearValue(DependencyProperty) en un DependencyObject sellado.

Ejemplos

En el ejemplo siguiente se recorren en iteración todas las propiedades que tienen valores locales establecidos en un objeto y, a continuación, se llama ClearValue a para borrar los valores de cada propiedad de este tipo.

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); }
        }
    }
}

Private Sub RestoreDefaultProperties(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim uic As UIElementCollection = Sandbox.Children
    For Each uie As Shape In uic
        Dim locallySetProperties As LocalValueEnumerator = uie.GetLocalValueEnumerator()
        While locallySetProperties.MoveNext()
            Dim propertyToClear As DependencyProperty = locallySetProperties.Current.Property
            If Not propertyToClear.ReadOnly Then
                uie.ClearValue(propertyToClear)
            End If
        End While
    Next
End Sub

Comentarios

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

Consulte también

• SetValue(DependencyProperty, Object)
• IsSealed
• DependencyProperty

ClearValue(DependencyPropertyKey)

Borra el valor local de una propiedad de solo lectura. La propiedad que se va a borrar se especifica mediante un DependencyPropertyKey.

public:
 void ClearValue(System::Windows::DependencyPropertyKey ^ key);

public void ClearValue (System.Windows.DependencyPropertyKey key);

member this.ClearValue : System.Windows.DependencyPropertyKey -> unit

Public Sub ClearValue (key As DependencyPropertyKey)

Parámetros

key

DependencyPropertyKey

Clave de la propiedad de dependencia que se va a borrar.

Excepciones

InvalidOperationException

Se intentó llamar a ClearValue(DependencyProperty) en un DependencyObject sellado.

Comentarios

un DependencyPropertyKey objeto identifica una propiedad de dependencia de solo lectura para las operaciones del sistema de propiedades. Las clases que definen propiedades de dependencia de solo lectura no deben exponer esta clave con acceso público. Una clave expuesta públicamente proporcionaría una ruta de código pública que negaba el carácter de solo lectura de la propiedad, si se podía llamar a métodos como ClearValue o SetValue podría llamarse fuera de la clase o ensamblado, haciendo referencia a la clave.

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

Consulte también

• SetValue(DependencyProperty, Object)
• DependencyPropertyKey