DependencyProperty.IsValidValue(Object) Método

Definição

Espaço de Nomes:
System.Windows
Assemblagem:
WindowsBase.dll

Determina se o valor fornecido é aceite para o tipo de propriedade através de verificação básica de tipos, e também potencialmente se está dentro do intervalo permitido de valores para esse tipo.

public:
 bool IsValidValue(System::Object ^ value);
public bool IsValidValue(object value);
member this.IsValidValue : obj -> bool
Public Function IsValidValue (value As Object) As Boolean

Parâmetros

value
Object

O valor a verificar.

Devoluções

Boolean

true se o valor for aceitável e for do tipo correto ou de um tipo derivado; caso contrário, false.

Exemplos

O exemplo seguinte é usado IsValidValue como verificação antes de chamar SetValue a propriedade de dependência.

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

Observações

Para uma propriedade de dependência, pode ser especificado um intervalo permitido de valores para esse tipo através de um ValidateValueCallback que é fornecido no registo da propriedade de dependência.

Este método chama IsValidType internamente. Se a propriedade de dependência em questão não ValidateValueCallbacktiver , então chamar este método é efetivamente equivalente a chamar IsValidType. Se a propriedade de dependência tiver um ValidateValueCallback, e se IsValidType tivesse devolto true, então o valor devolvido será como implementado no callback.

Um valor nulo é um valor válido para propriedades de dependência de tipo de referência, ou para uma Nullable<T> propriedade de dependência, e retornaria true para esses casos. Nos casos em que a propriedade de dependência não é nem uma referência nem um Nullable<T> tipo, IsValidType devolverá false um valor nulo em vez de levantar uma exceção.

Aplica-se a