Partager via


DependencyObject.CoerceValue(DependencyProperty) Méthode

Définition

Convertit la valeur de la propriété de dépendance spécifiée. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant.

public:
 void CoerceValue(System::Windows::DependencyProperty ^ dp);
public void CoerceValue (System.Windows.DependencyProperty dp);
member this.CoerceValue : System.Windows.DependencyProperty -> unit
Public Sub CoerceValue (dp As DependencyProperty)

Paramètres

dp
DependencyProperty

Identificateur de la propriété de dépendance à forcer.

Exceptions

Le dp spécifié ou sa valeur n’est pas valide ou n’existe pas.

Exemples

L’exemple suivant appelle CoerceValue dans une PropertyChangedCallback implémentation utilisée comme PropertyChangedCallback propriété de dépendance différente sur la même classe. Il s’agit d’un modèle courant pour introduire des dépendances de valeur vraies entre les propriétés de dépendance.

private static void OnCurrentReadingChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
  d.CoerceValue(MinReadingProperty);
  d.CoerceValue(MaxReadingProperty);
}
Private Shared Sub OnCurrentReadingChanged(ByVal d As DependencyObject, ByVal e As DependencyPropertyChangedEventArgs)
    d.CoerceValue(MinReadingProperty)
    d.CoerceValue(MaxReadingProperty)
End Sub

Remarques

En plus d’être explicitement appelé via l’appel CoerceValue, la CoerceValueCallback propriété de dépendance est également appelée en interne chaque fois que la valeur de propriété de dépendance est réévaluée par le système de propriétés WPF.

Lorsque vous appelez la CoerceValue méthode, vous appelez finalement le rappel de valeur de coerce pour la propriété que vous spécifiez. En règle générale, vous appelez CoerceValue uniquement si vous savez qu’un rappel de valeur coerce existe, et si vous connaissez les critères de rappel pour la contrainte.

Le scénario le plus courant pour l’appel CoerceValue se trouve dans la gestion des classes ou les rappels de modification de propriété des propriétés associées qui influencent les valeurs des uns et des autres de manière dépendante. Pour plus d’informations, consultez Validation et rappels de propriétés de dépendance.

S’applique à

Voir aussi