DependencyProperty.IsValidValue(Object) Méthode

Définition

Espace de noms:

System.Windows

Assembly:

WindowsBase.dll

Détermine si la valeur fournie est acceptée pour le type de propriété à travers la vérification de type de base, et également si elle se trouve dans la plage de valeurs autorisée pour ce type.

public:
 bool IsValidValue(System::Object ^ value);

public bool IsValidValue (object value);

member this.IsValidValue : obj -> bool

Public Function IsValidValue (value As Object) As Boolean

Paramètres

value

Object

Valeur à contrôler.

Retours

Boolean

true si la valeur est acceptable et est du type correct ou un type dérivé ; sinon, false.

Exemples

L’exemple suivant utilise IsValidValue comme vérification avant d’appeler SetValue la propriété de dépendance.

void TrySetValueWithValidate(DependencyObject target, DependencyProperty dp, object providedValue)
{
  if (dp.IsValidValue(providedValue))
  {
    target.SetValue(dp, providedValue);
  }
}

Private Sub TrySetValueWithValidate(ByVal target As DependencyObject, ByVal dp As DependencyProperty, ByVal providedValue As Object)
  If dp.IsValidValue(providedValue) Then
    target.SetValue(dp, providedValue)
  End If
End Sub

Remarques

Pour une propriété de dépendance, une plage de valeurs autorisée pour ce type peut être spécifiée via une ValidateValueCallback valeur fournie dans l’inscription de propriété de dépendance.

Cette méthode appelle IsValidType en interne. Si la propriété de dépendance en question n’a pas ValidateValueCallback, l’appel de cette méthode équivaut effectivement à appeler IsValidType. Si la propriété de dépendance a un ValidateValueCallback, et si IsValidType elle aurait retourné true, la valeur retournée sera telle qu’implémentée dans le rappel.

Une valeur Null est une valeur valide pour les propriétés de dépendance de type référence, ou pour une Nullable<T> propriété de dépendance, et retourne true pour ces cas. Dans les cas où la propriété de dépendance n’est ni une référence ni un Nullable<T> type, IsValidType retourne false une valeur Null au lieu de lever une exception.