DependencyObject.ClearValue Método

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

Excepciones

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

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

Excepciones

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