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

Exceções

Exemplos

O exemplo a seguir itera todas as propriedades que têm valores locais definidos em um objeto e, em seguida, chama ClearValue para limpar os valores de cada propriedade desse 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

Comentários

Limpar o valor da propriedade chamando ClearValue não necessariamente fornece a uma propriedade de dependência o valor padrão especificado nos metadados da propriedade de dependência. Limpar a propriedade apenas limpa especificamente qualquer valor local que possa ter sido aplicado. Para obter mais informações, consulte Precedência do valor da propriedade de dependência.

Confira também

• 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

Exceções

Comentários

Um DependencyPropertyKey identifica uma propriedade de dependência somente leitura para operações do sistema de propriedades. Classes que definem propriedades de dependência somente leitura não devem expor essa chave com acesso público. Uma chave exposta publicamente forneceria um caminho de código público que negava o caractere somente leitura da propriedade, se métodos como ClearValue ou SetValue pudessem ser chamados fora da classe ou assembly, fazendo referência à chave.

Limpar o valor da propriedade chamando ClearValue não necessariamente fornece a uma propriedade de dependência o valor padrão especificado nos metadados da propriedade de dependência. Limpar o valor apenas limpa especificamente qualquer valor local que possa ter sido aplicado. Para obter mais informações, consulte Precedência do valor da propriedade de dependência.

Confira também

• SetValue(DependencyProperty, Object)
• DependencyPropertyKey