Olá pessoal, meu objetivo deste post é falar um pouco sobre alguns Validators do VS. Primeiramente os Validators são componentes do Visual Studio que facilitam a validação das informações que um usuário digita em uma página WEB. Por exemplo, quando em um formulário você deseja definir alguns campos como obrigatório, validar e-mail, tratamento de datas válidas, etc.
Vou explicar mais detalhadamente como e quando utilizar os controles RequiredFieldValidator, RangeValidator, RegularExpressionVelidator, CompareValidator, CustomValidator e ValidationSummary que se encontram na Toolbox.
O RequiredFieldValidator é o componente que verificará se o campo configurado está preenchido, para isso, você deve arrastá-lo para seu formulário em frente ao campo que será validado:
E então configurar suas propriedades:
Na propriedade ErrorMessage, você colocará a mensagem que será exibida ao usuário e na propriedade ControlToValidate , a propriedade mais importante onde você definirá o nome do controle que será validado, no nosso caso txtcidade. Essas são as principais propriedades a serem configuradas do RequiredFieldValidator.
O próximo controle é o RangeValidator, ele dá a possibilidade de se validar valores entre um intervalo configurado.Neste exemplo vamos avaliar uma idade, se ela está entre 18 à 120 anos.
Começamos arrastando o controle para o formulário:
E alterando as seguintes propriedades:
Na propriedade ControlToValidate você colocará o Controle que será utilizado, no nosso caso txtIdade, escolheremos a mensagem a ser exibida no ErrorMessage, o valor máximo a ser comparado será colocado em MaximumValue,o valor mínimo em MinimumValue e o Type, que no nosso caso como estamos tratando de números inteiros, escolheremos Integer.
Agora vamos ver o Controle RegularExpressionValidator, que faz a validação de email, url, além dos RegularExpressions que podem ser personalizados.
Arrastando o controle para o Formulário
E agora configurando suas propriedades:
Colocamos a mensagem que será exibida ao usuário em ErrorMessage, na propriedade ControlToValidate escolhemos o campo que será validado, e em ValidationExpression iremos escolher qual RegularExpression que iremos usar, no nosso caso Internet e-mail address para validação do email e Internet URL para validação do Site. Para saber mais sobre como trabalhar com RegularExpressions customizadas acesse http://regexlib.com/default.aspx.
O CompareValidator é um controle que permite estar comparando datas, campos, etc. Neste exemplo vou comparar dois campos – Senha e Confirmação de Senha. Para isso arrasto o controle CompareValidator no formulário:
E então vou configurar as propriedades:
Na propriedade ErrorMessage será colocada a mensagem que será exibida ao usuário, na propriedade ControlToCompare será colocado o nome do controle que será comparado, no nosso caso o txtConfirmacaoSenha, no ControlToValidate será colocado o controle que servirá para comparação, no nosso caso o txtSenha, para definirmos que queremos que os campos sejam iguais, escolhemos o Operator como Equals e o Type será do tipo String pois podemos digitar números ou letras.
Utilizamos também o CompareValidator para validarmos uma data, basta você arrastar o controle para o formulário, e configurá-lo da seguinte maneira:
Na propriedade ControlToValidate colocaremos o campo que será validado, no nosso caso o txtAniversario, o ErrorMessage será “Data Inválida”, a propriedade Operator será definida como DataTypeCheck e a propriedade Type será do tipo Date.
Agora vou falar sobre o CustomValidator, este é um dos componentes de validação que podem ser personalizado. O exemplo a seguir verificará se o número digitado é divisível por 5.
Arrastando o Controle para a página:
E agora configurando suas propriedades:
Configuro o ControlToValidate com o textbox que será validado, e o ErrorMessage com a mensagem que será exibida ao usuário.
Agora iremos criar uma função customizada para validar os número divisíveis por 5.
Na linha 27 foi criado uma variável inteira que recebe o argumento, e na linha seguinte eu tenho o args.IsValid que pega o numero que foi digitado e divide por 5, se o resto for igual a 0 o Argumento é válido, então este numero é divisível por 5. Caso o usuário informe uma letra ao invés de um número e criado uma exceção.
Agora vamos associar esta função no HTML da página.
Na linha 17 iremos mostrar que nossa validação será feita no servidor para isso usaremos o comando OnServerValidate que indicará nossa função ValidaNumero. Lembrando também essa chamada pode ser feita com JavaScript mas utilizando o Comando ClientValidationFunction para chamar a função.
Agora por último vamos falar do ValidationSummary, tem como função exibir uma mensagem personalizada através de uma MessageBox contendo todas as validações.
Arrastando o Controle para o Form:
E configurando suas propriedades:
Na propriedade ShowMessageBox, você configura se quer exibir uma MessageBox, e no ShowSummary, você configura se quer exibir o resumo das validações:
