DependencyObject.ClearValue Método

Definição

Namespace:

System.Windows

Assembly:

WindowsBase.dll

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

InvalidOperationException

Tentativa de chamar ClearValue(DependencyProperty) em um DependencyObject lacrado.

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

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

InvalidOperationException

Tentativa de chamar ClearValue(DependencyProperty) em um DependencyObject lacrado.

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