DependencyProperty.IsValidValue(Object) Methode

Definition

Namespace:

System.Windows

Assembly:

WindowsBase.dll

Bestimmt, ob der angegebene Wert für den Eigenschaftentyp durch eine einfache Typüberprüfung zulässig ist und ob er sich potenziell im zulässigen Wertebereich für den Typ befindet.

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

public bool IsValidValue (object value);

member this.IsValidValue : obj -> bool

Public Function IsValidValue (value As Object) As Boolean

Parameter

value

Object

Der zu überprüfende Wert.

Gibt zurück

Boolean

true, wenn der Wert zulässig ist und den richtigen Typ oder einen abgeleiteten Typ aufweist, andernfalls false.

Beispiele

Im folgenden Beispiel wird IsValidValue vor dem Aufrufen SetValue der Abhängigkeitseigenschaft eine Überprüfung verwendet.

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

Hinweise

Bei einer Abhängigkeitseigenschaft kann ein zulässiger Wertebereich für diesen Typ über eine ValidateValueCallback in der Abhängigkeitseigenschaftsregistrierung angegebene Wertebereich angegeben werden.

Diese Methode ruft intern auf IsValidType . Wenn die betreffende Abhängigkeitseigenschaft keinen ValidateValueCallbackWert aufweist, entspricht das Aufrufen dieser Methode effektiv dem Aufrufen IsValidType. Wenn die Abhängigkeitseigenschaft über eine ValidateValueCallback, und wenn IsValidType sie zurückgegeben wurde , wird der zurückgegebene trueWert wie im Rückruf implementiert.

Ein Nullwert ist ein gültiger Wert für Bezugstypabhängigkeitseigenschaften oder für eine Nullable<T> Abhängigkeitseigenschaft und würde für diese Fälle zurückgegeben true . In Fällen, in denen die Abhängigkeitseigenschaft weder ein Verweis noch ein Nullable<T> Typ ist, IsValidType wird für einen NULL-Wert zurückgegeben, anstatt eine Ausnahme zu false auslösen.