DependencyProperty.IsValidValue(Object) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Určuje, zda je zadaná hodnota přijata pro typ vlastnosti prostřednictvím základní kontroly typů, a také pokud je v povoleném rozsahu hodnot pro daný typ.
public:
bool IsValidValue(System::Object ^ value);
public bool IsValidValue (object value);
member this.IsValidValue : obj -> bool
Public Function IsValidValue (value As Object) As Boolean
Parametry
- value
- Object
Hodnota, která se má zkontrolovat.
Návraty
true
je-li hodnota přijatelná a má správný typ nebo odvozený typ; false
v opačném případě .
Příklady
Následující příklad používá IsValidValue jako kontrolu před voláním SetValue vlastnosti závislostí.
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
Poznámky
U vlastnosti závislosti lze povolený rozsah hodnot pro tento typ zadat prostřednictvím ValidateValueCallback vlastnosti, která je poskytována v registraci vlastnosti závislosti.
Tato metoda volá IsValidType interně. Pokud vlastnost závislosti nemá žádnou ValidateValueCallback, volání této metody je účinně ekvivalentní volání IsValidType. Pokud má vlastnost závislosti hodnotu ValidateValueCallbacka pokud IsValidType by byla vrácena true
, bude vrácena hodnota jako implementovaná v zpětném volání.
Hodnota null je platná hodnota pro vlastnosti závislostí typu odkazu nebo pro Nullable<T> vlastnost závislostí a v těchto případech by se vrátila true
. V případech, kdy závislost není odkaz ani Nullable<T> typ, vrátí false
hodnotu null místo IsValidType vyvolání výjimky.