Compartilhar via


DependencyObject.ClearValue Método

Definição

Limpa o valor local de uma propriedade.

Sobrecargas

ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um identificador DependencyProperty.

ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade somente leitura. A propriedade a ser limpa é especificada por um DependencyPropertyKey.

ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade. A propriedade a ser limpa é especificada por um 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

A propriedade de dependência a ser limpa, identificada por uma referência de objeto DependencyProperty.

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

Aplica-se a

ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade somente leitura. A propriedade a ser limpa é especificada por um 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

A chave para a propriedade de dependência a ser limpa.

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

Aplica-se a