ValidationRule Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece uma maneira de criar uma regra personalizada para verificar a validade da entrada do usuário.
public ref class ValidationRule abstract
public abstract class ValidationRule
type ValidationRule = class
Public MustInherit Class ValidationRule
- Herança
-
ValidationRule
- Derivado
Exemplos
O exemplo a seguir mostra como implementar uma regra de validação. O valor de entrada será inválido se ele contiver caracteres não numéricos ou se estiver fora dos limites inferior e superior. Se o valor do retornado ValidationResult for inválido, a ErrorContent propriedade será definida como a mensagem de erro apropriada e a IsValid propriedade será definida como false.
Para obter o exemplo completo, consulte Como implementar a validação de associação.
public class AgeRangeRule : ValidationRule
{
public int Min { get; set; }
public int Max { get; set; }
public AgeRangeRule()
{
}
public override ValidationResult Validate(object value, CultureInfo cultureInfo)
{
int age = 0;
try
{
if (((string)value).Length > 0)
age = Int32.Parse((String)value);
}
catch (Exception e)
{
return new ValidationResult(false, $"Illegal characters or {e.Message}");
}
if ((age < Min) || (age > Max))
{
return new ValidationResult(false,
$"Please enter an age in the range: {Min}-{Max}.");
}
return ValidationResult.ValidResult;
}
}
Comentários
Ao usar o modelo de associação de dados do WPF, você pode associar ValidationRules ao objeto de associação. Para criar regras personalizadas, faça uma subclasse dessa classe e implemente o Validate método. Opcionalmente, use o interno ExceptionValidationRule, que captura exceções que são geradas durante as atualizações de origem ou a DataErrorValidationRule, que verifica se há erros gerados pela implementação do objeto de origem IDataErrorInfo .
O mecanismo de associação verifica cada ValidationRule um que está associado a uma associação sempre que transfere um valor de entrada, que é o valor da propriedade de destino de associação, para a propriedade de origem de associação.
Para obter informações detalhadas sobre a validação de dados, consulte Visão geral da associação de dados.
Para obter informações sobre como validar dados fornecidos pelo usuário em uma caixa de diálogo, consulte a Visão geral das caixas de diálogo.
Construtores
| Nome | Description |
|---|---|
| ValidationRule() |
Inicializa uma nova instância da classe ValidationRule. |
| ValidationRule(ValidationStep, Boolean) |
Inicializa uma nova instância da ValidationRule classe com a etapa de validação especificada e um valor que indica se a regra de validação é executada quando o destino é atualizado. |
Propriedades
| Nome | Description |
|---|---|
| ValidatesOnTargetUpdated |
Obtém ou define um valor que indica se a regra de validação é executada quando o destino do Binding é atualizado. |
| ValidationStep |
Obtém ou define quando a regra de validação é executada. |
Métodos
| Nome | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |
| Validate(Object, CultureInfo, BindingExpressionBase) |
Executa verificações de validação em um valor. |
| Validate(Object, CultureInfo, BindingGroup) |
Executa verificações de validação em um valor. |
| Validate(Object, CultureInfo) |
Quando substituído em uma classe derivada, executa verificações de validação em um valor. |