DependencyProperty.IsValidValue(Object) Método

Definição

Determina se o valor fornecido é aceito para o tipo de propriedade por meio de verificação de tipo básica e também potencialmente se ele está dentro do intervalo permitido de valores para esse tipo.Determines whether the provided value is accepted for the type of property through basic type checking, and also potentially if it is within the allowed range of values for that type.

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 ser verificado.The value to check.

Retornos

true se o valor é aceitável e é do tipo correto ou um tipo derivado; caso contrário, false.true if the value is acceptable and is of the correct type or a derived type; otherwise, false.

Exemplos

O exemplo a seguir usa IsValidValue como uma verificação antes de chamar SetValue na propriedade de dependência.The following example uses IsValidValue as a check before calling SetValue on the dependency property.

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

Comentários

Para uma propriedade de dependência, um intervalo permitido de valores para esse tipo pode ser especificado por meio de um ValidateValueCallback fornecido no registro da propriedade de dependência.For a dependency property, an allowed range of values for that type can be specified through a ValidateValueCallback that is provided in the dependency property registration.

Esse método chama IsValidType internamente.This method calls IsValidType internally. Se a propriedade de dependência em questão não tiver nenhum ValidateValueCallback, chamar esse método será efetivamente equivalente a chamar IsValidType.If the dependency property in question has no ValidateValueCallback,then calling this method is effectively equivalent to calling IsValidType. Se a propriedade de dependência tiver um ValidateValueCallbacke, se IsValidType tiver retornado true, o valor retornado será conforme implementado no retorno de chamada.If the dependency property does have a ValidateValueCallback, and if IsValidType would have returned true, then the value returned will be as implemented in the callback.

Um valor nulo é um valor válido para propriedades de dependência do tipo de referência ou para uma propriedade de dependência Nullable<T> e retorna true para esses casos.A null value is a valid value for reference type dependency properties, or for a Nullable<T> dependency property, and would return true for these cases. Nos casos em que a propriedade de dependência não é uma referência nem um tipo de Nullable<T>, IsValidType retornará false para um valor nulo em vez de gerar uma exceção.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.

Aplica-se a