DependencyObject.ClearValue Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Efface la valeur locale d’une propriété.
Surcharges
| Nom | Description |
|---|---|
| ClearValue(DependencyProperty) |
Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un DependencyProperty identificateur. |
| ClearValue(DependencyPropertyKey) |
Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par un DependencyPropertyKey. |
ClearValue(DependencyProperty)
Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un DependencyProperty identificateur.
public:
void ClearValue(System::Windows::DependencyProperty ^ dp);public void ClearValue(System.Windows.DependencyProperty dp);member this.ClearValue : System.Windows.DependencyProperty -> unitPublic Sub ClearValue (dp As DependencyProperty)Paramètres
Propriété de dépendance à effacer, identifiée par une référence d’objet DependencyProperty .
Exceptions
Tentative d’appel ClearValue(DependencyProperty) sur un scellé DependencyObject.
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 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é efface uniquement la valeur locale qui a pu être appliquée. Pour plus d’informations, consultez Priorité des valeurs 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 un DependencyPropertyKey.
public:
void ClearValue(System::Windows::DependencyPropertyKey ^ key);public void ClearValue(System.Windows.DependencyPropertyKey key);member this.ClearValue : System.Windows.DependencyPropertyKey -> unitPublic Sub ClearValue (key As DependencyPropertyKey)Paramètres
Clé de la propriété de dépendance à effacer.
Exceptions
Tentative d’appel ClearValue(DependencyProperty) sur un scellé DependencyObject.
Remarques
A DependencyPropertyKey identifie 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 fournit un chemin de code public qui annule le caractère en lecture seule de la propriété, si des méthodes telles que ClearValue ou SetValue peuvent être appelées en dehors de la classe ou de l’assembly, faisant référence à 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 uniquement la valeur locale qui a pu être appliquée. Pour plus d’informations, consultez Priorité des valeurs de propriété de dépendance.
