DependencyObject.ClearValue Méthode

Définition

Espace de noms:

System.Windows

Assembly:

WindowsBase.dll

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.

C#

public void ClearValue(System.Windows.DependencyProperty dp);

Paramètres

dp

DependencyProperty

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

Exceptions

InvalidOperationException

Tentative d’appel à ClearValue(DependencyProperty) sur un DependencyObject sealed.

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 chacune de ces propriétés.

C#

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); }
        }
    }
}

Remarques

L’effacement de la valeur de la 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 la propriété de dépendance. L’effacement de la propriété efface uniquement spécifiquement toute valeur locale qui peut avoir été appliquée. Pour plus d’informations, consultez Priorité de la valeur de propriété de dépendance.

Voir aussi

• SetValue(DependencyProperty, Object)
• IsSealed
• DependencyProperty

ClearValue(DependencyPropertyKey)

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

C#

public void ClearValue(System.Windows.DependencyPropertyKey key);

Paramètres

key

DependencyPropertyKey

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

Exceptions

InvalidOperationException

Tentative d’appel à ClearValue(DependencyProperty) sur un DependencyObject sealed.

Remarques

Un DependencyPropertyKey identifie une propriété de dépendance en lecture seule pour les opérations de 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 un chemin de code public qui annulait le caractère en lecture seule de la propriété, si des méthodes telles que ClearValue ou SetValue pourraient être appelées en dehors de la classe ou de l’assembly, référençant la clé.

L’effacement de la valeur de la 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 la propriété de dépendance. L’effacement de la valeur efface uniquement spécifiquement toute valeur locale qui peut avoir été appliquée. Pour plus d’informations, consultez Priorité de la valeur de propriété de dépendance.

Voir aussi

• SetValue(DependencyProperty, Object)
• DependencyPropertyKey