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 070 - Capítulo 09 - CheckBox Web Server Control

Este controle é utilizado para a criação de um controle do tipo caixa de seleção. Este tipo de controle pode assumir dois estados: marcado ou não marcado. Ao clicar no controle o seu estado é alterado, isto é, se estiver marcado, ele será desmarcado; se estiver desmarcado, ele será marcado.

O evento CheckedChanged é disparado quando o formulário é enviado para o servidor e o estatus (marcado/desmarcado) do controle foi alterado em relação ao último envio do formulário.

NOTA: Para criar múltiplos controles do tipo CheckBox, de uma só vez, ligados a uma fonte de dados, devemos utilizar o controle CheckBoxList. Aprenderemos a utilizar este controle nos Capítulos 10 e 11.

A sintaxe para este controle é a seguinte:

<asp:CheckBox

id="identificação_no_código"

AutoPostBack="True|False"

Text="Rótulo de texto associado ao  controle."

TextAlign="Right|Left"

Checked="True|False"

OnCheckedChanged="Método que será executado em  resposta ao evento

OnCheckedChanged"

runat="server"

/>

Vamos apresentar um exemplo de utilização do controle CheckBox. O nosso exemplo é constituído de um formulário no qual temos três controles do tipo CheckBox, onde o usuário pode selecionar um ou mais controles. Ao clicar no botão Enviar, o evento Click deste botão informa, em um controle do tipo Label, quais as opções selecionadas.

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

Listagem 9.3 – O controle CheckBox – chap9ex3.aspx.

<html>

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

      public void  Enviar_Click(Object sender,EventArgs e)

                         //Declaração das variáveis auxiliares

             String Aux="Opções selecionadas:  " ;

                         // Começo a montar uma string que será  atribuída à

             // propriedade Value do controle Dados.

            if  (Negócios.Checked==true)

                        Aux= Aux  +"Negócios  ";

            if  (Direito.Checked==true)

                        Aux= Aux  +"Direito  ";

            if  (Economia.Checked==true)

                        Aux= Aux  +"Economia  ";

             Exibe.Text = Aux;

</script>

<body>

   <form  method=post runat="server">

            <table>

            <tr>

                 <td colspan="2"><H2>Selecione as áreas de  interesse:</H2></td>

            </tr>

            <tr>

                 <td><B>Opção 1:</B> </td>

                 <td>

                        <asp:CheckBox

id="Negócios"  runat="server"

                        Text="Negócios"

            AutoPostBack="True"

/>

                </td>

            </tr>

            <tr>

                 <td><B>Opção 2:</B> </td>

                 <td>

                        <asp:CheckBox

id="Direito"

runat="server"

                        Text="Direito"

              AutoPostBack="True"

/>

                </td>

            </tr>

            <tr>

                <td><B>Opção 3:</B> </td>

                <td>

                        <asp:CheckBox

id="Economia"

runat="server"

                        Text="Economia"

                                    AutoPostBack="True"

/>

                </td>

            </tr>

            <tr>

                <td><B>Clique no botão  --></B></td>

                  <td>

                            <input  type=submit value="Enviar" OnServerClick="Enviar_Click"

                             runat="server">

    </td>

            </tr>

            <tr>

                 <td><B>Dados do cliente:</B> </td>

                <td>

<b>

                                   <asp:Label

                                               id="Exibe"

                                   Text=""

                                               BackColor="Black"

                                               ForeColor="White"

                                               runat="server"

/>

            </b>

                </td>

            </tr>

     </table>

</form>

</body>

</html>

Digite o código da Listagem 9.3 e salve o mesmo em um arquivo chamado chap9ex3.aspx, na pasta chap9, 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/chap9/chap9ex3.aspx

Ao carregar a página será exibido um formulário com três controles do tipo CheckBox, o botão Enviar e um controle do tipo Label. Selecione as opções Negócios e Economia. Dê um clique no botão Enviar. As opções selecionadas serão informadas em um controle do tipo Label, conforme indicado na Figura 9.3.

Curso Completo de ASP.NET - Júlio Battisti
Figura 9.3 Utilizando o controle CheckBox – chap9ex3.aspx.

Neste exemplo estamos utilizando a propriedade Checked para verificar se o controle foi ou não selecionado. No final do procedimento Enviar_Click, definimos o texto do controle do tipo Label, como sendo igual ao conteúdo da variável Aux. Observe que para fazer esta definição utilizamos a propriedade Text, conforme indicado no comando a seguir:

Exibe.Text = Aux;