DependencyObject.ClearValue Méthode

Définition

Efface la valeur locale d’une propriété.

Surcharges

ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty.

ClearValue(DependencyPropertyKey)

Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey.

ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur 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)

Paramètres

dp
DependencyProperty

Propriété de dépendance à effacer, identifiée par une référence d’objet DependencyProperty.

Exceptions

Exemples

L’exemple suivant itère toutes les propriétés dont les valeurs locales sont définies sur un objet, puis appelle ClearValue pour effacer les valeurs de chaque propriété de ce type.

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

Remarques

L’effacement de la valeur de propriété en appelant ClearValue ne donne pas nécessairement à une propriété de dépendance la valeur par défaut spécifiée dans les métadonnées de propriété de dépendance. L’effacement de la propriété ne supprime spécifiquement que la valeur locale qui a peut-être été appliquée. Pour plus d’informations, consultez Priorité de la valeur de propriété de dépendance.

Voir aussi

S’applique à

ClearValue(DependencyPropertyKey)

Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par 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)

Paramètres

key
DependencyPropertyKey

Clé de la propriété de dépendance à effacer.

Exceptions

Remarques

DependencyPropertyKeyIdentifie une propriété de dépendance en lecture seule pour les opérations du système de propriétés. Les classes qui définissent des propriétés de dépendance en lecture seule ne doivent pas exposer cette clé avec un accès public. Une clé exposée publiquement fournirait une voie de code publique qui a inversé le caractère en lecture seule de la propriété, si des méthodes telles que ClearValue ou SetValue pouvaient être appelées en dehors de la classe ou de l’assembly, référençant la clé.

L’effacement de la valeur de propriété en appelant ClearValue ne donne pas nécessairement à une propriété de dépendance la valeur par défaut spécifiée dans les métadonnées de propriété de dépendance. L’effacement de la valeur efface spécifiquement toute valeur locale qui a pu être appliquée. Pour plus d’informations, consultez Priorité de la valeur de propriété de dépendance.

Voir aussi

S’applique à