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 als Überprüfung verwendet, bevor die Abhängigkeitseigenschaft aufgerufen wird SetValue .

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

Für eine Abhängigkeitseigenschaft kann ein zulässiger Wertebereich für diesen Typ über einen ValidateValueCallback angegeben werden, der in der Abhängigkeitseigenschaftsregistrierung bereitgestellt wird.

Diese Methode ruft intern auf IsValidType . Wenn die betreffende Abhängigkeitseigenschaft keine ValidateValueCallbackaufweist, entspricht das Aufrufen dieser Methode effektiv dem Aufrufen IsValidTypevon . Wenn die Abhängigkeitseigenschaft über einen ValidateValueCallbackverfügt und wenn IsValidType zurückgegeben worden wäre true, wird der zurückgegebene Wert wie im Rückruf implementiert.

Ein NULL-Wert ist ein gültiger Wert für Abhängigkeitseigenschaften vom Verweistyp 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, wird für einen NULL-Wert zurückgegebenfalse, IsValidType anstatt eine Ausnahme auszulösen.