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

Définition

Efface la valeur locale d’une propriété.Clears the local value of a property.

Surcharges

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

Efface la valeur locale d’une propriété.Clears the local value of a property. La propriété à effacer est spécifiée par un identificateur DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

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

Efface la valeur locale d’une propriété en lecture seule.Clears the local value of a read-only property. La propriété à effacer est spécifiée par DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

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

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

Paramètres

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Propriété de dépendance à effacer, identifiée par une référence d’objet DependencyProperty.The dependency property to be cleared, identified by a DependencyProperty object reference.

Exceptions

Exemples

L’exemple suivant itère toutes les propriétés qui ont des valeurs locales définies sur un objet, puis appelle ClearValue pour effacer les valeurs de chacune de ces propriétés.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

Remarques

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 qui est spécifiée dans les métadonnées de propriété de dépendance.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. Désactivez la propriété uniquement spécifiquement efface toute valeur de proximité ont pu être appliqué.Clearing the property only specifically clears whatever local value may have been applied. Pour plus d’informations, consultez Priorité de la valeur de propriété de dépendance.For more information, see Dependency Property Value Precedence.

Voir aussi

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

Efface la valeur locale d’une propriété en lecture seule.Clears the local value of a read-only property. La propriété à effacer est spécifiée par 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)

Paramètres

key
DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey

Clé de la propriété de dépendance à effacer.The key for the dependency property to be cleared.

Exceptions

Remarques

Un DependencyPropertyKey identifie une propriété de dépendance en lecture seule pour les opérations de système de propriétés.A DependencyPropertyKey identifies a read-only dependency property for property system operations. Les classes qui définissent les propriétés de dépendance en lecture seule ne doivent pas exposer cette clé avec un accès public.Classes that define read-only dependency properties should not expose this key with public access. Une clé exposée publiquement fournirait une voie d’accès de code publique qui inverser le caractère en lecture seule de la propriété, si des méthodes telles que ClearValue ou SetValue peut être appelée en dehors de la classe ou d’un assembly, en référençant la clé.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.

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 qui est spécifiée dans les métadonnées de propriété de dépendance.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. Effacement de la valeur uniquement spécifiquement efface toute valeur de proximité ont pu être appliqué.Clearing the value only specifically clears whatever local value may have been applied. Pour plus d’informations, consultez Priorité de la valeur de propriété de dépendance.For more information, see Dependency Property Value Precedence.

Voir aussi

S’applique à