DependencyObject.ClearValue DependencyObject.ClearValue DependencyObject.ClearValue DependencyObject.ClearValue Method

Definição

Limpa o valor local de uma propriedade.Clears the local value of a property.

Sobrecargas

ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade.Clears the local value of a property. A propriedade a ser limpa é especificada por um identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade somente leitura.Clears the local value of a read-only property. A propriedade a ser limpa é especificada por um DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

Limpa o valor local de uma propriedade.Clears the local value of a property. A propriedade a ser limpa é especificada por um identificador DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

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 DependencyProperty DependencyProperty DependencyProperty

A propriedade de dependência a ser limpa, identificada por uma referência de objeto DependencyProperty.The dependency property to be cleared, identified by a DependencyProperty object reference.

Exceções

Exemplos

O exemplo a seguir itera todas as propriedades que têm valores locais definidos em um objeto e, ClearValue em seguida, chama para limpar os valores de cada propriedade.The following example iterates all properties that have local values set on an object, then calls ClearValue to clear the values of each such property.

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 dá à propriedade de dependência o valor padrão que é especificado nos metadados da propriedade de dependência.Clearing the property value by calling ClearValue does not necessarily give a dependency property the default value that is specified in the dependency property metadata. Limpar a propriedade só limpa especificamente qualquer valor local que possa ter sido aplicado.Clearing the property only specifically clears whatever local value may have been applied. Para obter mais informações, consulte Precedência do valor da propriedade de dependência.For more information, see Dependency Property Value Precedence.

Veja também

ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

Limpa o valor local de uma propriedade somente leitura.Clears the local value of a read-only property. A propriedade a ser limpa é especificada por um DependencyPropertyKey.The property to be cleared is specified by a 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 DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey

A chave para a propriedade de dependência a ser limpa.The key for the dependency property to be cleared.

Exceções

Comentários

Um DependencyPropertyKey identifica uma propriedade de dependência somente leitura para operações do sistema de propriedades.A DependencyPropertyKey identifies a read-only dependency property for property system operations. Classes que definem propriedades de dependência somente leitura não devem expor essa chave com acesso público.Classes that define read-only dependency properties should not expose this key with public access. 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 puderem ser chamados fora da classe ou do assembly, fazendo referência à chave.A publicly exposed key would provide a public code pathway that negated the read-only character of the property, if methods such as ClearValue or SetValue could be called outside the class or assembly, referencing the key.

Limpar o valor da propriedade chamando ClearValue não necessariamente dá à propriedade de dependência o valor padrão que é especificado nos metadados da propriedade de dependência.Clearing the property value by calling ClearValue does not necessarily give a dependency property the default value that is specified in the dependency property metadata. Limpar o valor apenas limpa especificamente qualquer valor local que possa ter sido aplicado.Clearing the value only specifically clears whatever local value may have been applied. Para obter mais informações, consulte Precedência do valor da propriedade de dependência.For more information, see Dependency Property Value Precedence.

Veja também

Aplica-se a