DependencyProperty.IsValidType(Object) Method

Definition

Determines whether a specified value is acceptable for this dependency property's type, as checked against the property type provided in the original dependency property registration.

public bool IsValidType (object value);

Parameters

value
Object

The value to check.

Returns

true if the specified value is the registered property type or an acceptable derived type; otherwise, false.

Examples

The following example uses IsValidType as a check before calling SetValue on the dependency property.

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

Remarks

A value of null is a valid type for reference type dependency properties, or for a Nullable<T> dependency property, and would return true for these cases. In cases where the dependency property is neither a reference nor a Nullable<T> type, IsValidType will return false for a null value rather than raise an exception.

Applies to

Product Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9