Conheça o Júlio Battisti

Julio Battisti - Autor de mais de 25 livros de informática Júlio Battisti tem mais de 50 livros publicados, centenas de e-books e é certificado Microsoft.

SAIBA MAIS...

Loja Virtual do Site

Curta Nossa Fanpage

« Lição anterior

Δ Página principal

¤ Capítulos

Próxima lição »

ASP.NET - CURSO COMPLETO
Autor: Júlio Battisti

Lição 062 - Capítulo 08 - O controle RangeValidator

No item anterior estudamos o controle CompareValidator, o qual permite fazer validações com base em um determinado valor e um operador de comparação. Para comparações que envolvem uma faixa de valores (com limites inferior e superior), precisamos utilizar o controle RangeValidator. Por exemplo, com o controle RangeValidator podemos verificar se os valores digitados no campo Salário estão entre 1000 e 5000.

A sintaxe para este controle é a seguinte:

<asp:RangeValidator

            id="identificação  no código"

            runat="server"

            ControlToValidate="nome  do controle associado"

            MinimumValue="limite  inferior da faixa"

            MaximumValue=”limite  superior da faixa”

            Type="Tipo  do valor a ser comparado: string, Int32, Double, etc."

            ErrorMessage="Mensagem  de erro."

                 ForeColor="Cor da fonte."

            BackColor="Cor  de segundo plano"

</asp:RangeValidator>

Uma sintaxe alternativa é a seguinte:

<asp:RangeValidator

            id="identificação  no código"

            runat="server"

            ControlToValidate="nome  do controle associado"

            MinimumValue="limite  inferior da faixa"

            MaximumValue=”limite  superior da faixa”

            Type="Tipo  do valor a ser comparado: string, Int32, Double, etc."

            ErrorMessage="Mensagem  de erro."

                 ForeColor="Cor da fonte."

            BackColor="Cor  de segundo plano"

/>

Observe que ao invés de fechar a tag desta maneira: </asp:RangeValidator>, simplesmente utilizamos um />. As duas sintaxes são válidas.

Vamos destacar os seguintes atributos:

MinimumValue: Define o limite inferior da faixa.
MaximumValue: Define o limite superior da faixa.

Nota: Os valores definidos em MinimumValue e MaximumValue também fazem parte da faixa de valores permitidos. Por exemplo, se MinimumValue for definido em 20 e MaximumValue for definido em 50; os valores permitidos são: Maior ou igual a 20 e Menor ou igual a 50.

Vamos a um exemplo simples. Vamos criar um formulário onde temos um campo para digitação, onde deve ser digitado um valor maior ou igual a 50 e menor ou igual a 100. Vamos utilizar um controle RangeValidator para verificar se o número digitado atende o critério de estar na faixa entre 50 e 100.

Na Listagem 8.4 temos o código para o exemplo proposto.

Listagem 8.4 – O controle de validação RangeValidator.

<html>

<head>

   <script  language="C#" runat="server">

  void  Enviar_Click(Object sender, EventArgs e)

            // Código  para gravar os dados recebidos no

            // banco de  dados.

   </script>

</head>

<body>

   <form  runat=server>

            <h3>Exemplo  do controle RangeValidator!!!</h3>

            <input  id="valor" type=text size=40 runat="server">

            <BR>

<B>

            <asp:RangeValidator

            id="valida_valor"

            runat="server"

            ControlToValidate="valor"

            MinimumValue="20"

            MaximumValue="50"

            Type="Double"

            ErrorMessage="Digite  um valor entre 20 e 50!!"

ForeColor="Blue"

            BackColor="Cyan"

            </asp:RangeValidator>

            </B>

            <BR>

            <BR>

            <input  type=submit value="Enviar" OnServerClick="Enviar_Click"  runat="server">

</form>

</body>

</html>

Digite o código da Listagem 8.4 e salve o mesmo em um arquivo chamado chap8ex4.aspx, na pasta chap8, dentro da pasta wwwroot, conforme descrito no item: “Check List para acompanhar os exemplos deste livro”, no Capítulo 6.

Para acessar esta página utilize o seguinte endereço:

http://localhost/chap8/chap8ex4.aspx

No campo valor digite 35, que é um valor dentro da faixa definida no controle RangeValidator: entre 20 e 50. Dê um clique no botão Enviar. Observe que nenhuma mensagem de erro é emitida.

Agora digite 15 no campo valor. Dê um clique no botão Enviar. Você obterá uma mensagem de erro, conforme indicado na Figura 8.7.

Curso Completo de ASP.NET - Júlio Battisti
Figura 8.7 O controle de validação RangeValidator entrando em ação.

Observe que nesta caso o campo de validação detectou que o campo valor possui um valor fora da faixa (entre 20 e 50) e a mensagem de erro foi exibida.