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 068 - Capítulo 09 - TextBox Web Server Control

Este controle é utilizado para criar um caixa de texto para digitação de texto. Podemos criar uma caixa de texto de uma única linha ou de múltiplas linhas (o que criávamos utilizando um HTMLTextArea Server Control).

Por padrão a propriedade TextMode é definida como SingleLine, o que significa que o controle tem uma única linha. Para definir este controle com múltiplas linhas, devemos definir a propriedade TextMode para MultiLine. Também podemos definir esta propriedade com o valor Password, para criar um texto para digitação de senhas, onde são exibidos apenas asteriscos enquanto o usuário digita a senha.

A largura da caixa de texto é definida pela propriedade Columns. Se a caixa de texto for de múltiplas linhas, a sua altura é definida pela propriedade Rows. Este controle é derivado da classe TextBox, do namespace System.Web.UI.WebControls.

A sintaxe para este controle é a seguinte:

<asp:TextBox id=value     AutoPostBack="True|False"     Columns="Número de colunas"     MaxLength="Tamanho máximo do texto a ser digitado"

     Rows="Número de linhas."

     Text="Texto para a caixa de digitação."

     TextMode="Single | Multiline | Password"

     Wrap="True|False"

OnTextChanged="OnTextChangedMethod"     runat="server"/>

A propriedade AutoPostBack é do tipo Boleana, podendo assumir os valores True ou False. Se o valor desta propriedade estiver definido em True, um PostBack será gerado para o servidor, toda vez que o valor do controle for alterado. Por padrão o valor desta propriedade é definido como False. Se for definida para True, toda vez que o valor do controle for alterado, o controle reenvia para o servidor (postback) o seu valor e o valor de todos os controles do formulário. Algo parecido com disparar um evento “Após alterar”, para um campo de um formulário criado com o Microsoft Access ou com o VB.

A propriedade Wrap define se deve ser feita uma quebra automática de linha, cada vez que o texto atinge o limite da caixa de texto.

OnTextChanged é um método que dispara o evento TextChanged, para a qual podemos definir um procedimento que será executado em resposta ao evento.

Vamos a um exemplo simples. Vamos criar um formulário onde temos três campos:

Nome
Senha
Comentários

O usuário preenche os dados e clica no botão Enviar. Vamos criar um procedimento para o evento Click do botão Enviar. Este procedimento irá exibir, em um controle HtmlTextArea, os valores digitados pelo usuário, com exceção da senha.

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

Listagem 9.1 – O controle TextBox – chap9ex1.aspx.

<html>

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

      public void  Enviar_Click(Object sender,EventArgs e)

                        Exibe.Value = Nome.Text  + "\n" + "Seus comentários:"

                                         + "\n" + Comentários.Text;

</script>

<body>

    <form method=post runat="server">

            <H2> Exemplo do  controle TextBox!!</H2>

<table>

            <tr>

                 <td><h3>Nome:</h3> </td>

                <td>

                        <asp:TextBox  runat=server

                             id="Nome"

                             Text=""

                             Font_Face="Arial"

                             Font_Size="3"

                             BackColor="Cyan"

                             ForeColor="Blue"

                             BorderColor="Red"

                             TextMode="SingleLine"

                             Columns="40"

/>

                 </td>

            </tr>

            <tr>

                 <td><h3>Senha:</h3> </td>

                <td>

                        <asp:TextBox  runat=server

                             id="Senha"

                             Text=""

                             Font_Face="Arial"

                             Font_Size="3"

                             BackColor="Cyan"

                             ForeColor="Blue"

                             BorderColor="Green"

                             TextMode="Password"

                             Columns="40"

/>

                </td>

            </tr>

            <tr>

                 <td><h3>Comentários:</h3> </td>

                <td>

                        <asp:TextBox  runat=server

                             id="Comentários"

                             Text=""

                             Font_Face="Arial"

                             Font_Size="2"

                             BackColor="Silver"

                             ForeColor="Blue"

                             BorderColor="Green"

                             TextMode="MultiLine"

                             Rows="10"

                             Columns="30"

/>

                </td>

            </tr>

            <tr>

                 <td><h3>Você digitou:</h3></td>

                  <td><textarea id="Exibe" cols="40"  rows="5" runat="server" /></td>

            </tr>

            <tr>

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

                  <td>

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

runat="server">

    </td>

            </tr>

            </table>

    </form>

</body>

</html>

Digite o código da Listagem 9.1 e salve o mesmo em um arquivo chamado chap9ex1.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/chap9ex1.aspx

No campo Nome digite: José abc da silva.

No campo Senha digite: 123456.

No campo de comentários digite o seguinte texto:

“Estudo dos Web Form Controls do ASP.NET.

Controles avançados e com melhor interface visual,

com acesso a uma variedade de métodos, propriedades

e eventos.”

Dê um clique no botão Enviar. Você obterá o resultado indicado na Figura 9.1.

Curso Completo de ASP.NET - Júlio Battisti
Figura 9.1 Utilizando o controle TextBox com as opções SingleLine, Password e MultiLIne.

Observe que o controle que exibe os valores digitados pelo usuário não consegue exibir todo o conteúdo digitado, por isso uma barra de rolagem vertical é disponibilizada.

No evento Click do botão Enviar, definimos a propriedade Value do controle Exibe como sendo a concatenação dos valores digitados nos campos Nome e Comentários. Para concatenar strings, apenas para lembrar, utilizamos o operador +. O “\n” define uma quebra de linha. Também é importante salienter que, para obter o valor digitado nos controles, utilizamos a propriedade Text . Nos controles do tipo HtmlServer, utilizávamos a propriedade Value, ao invés da propriedade Text. Aliás estamos fazendo isto neste exemplo, pois o controle que exibe os valores digitados pelo usuário é um controle do tipo HtmlServer. Para definir o que o controle irá exibir, estamos definindo a sua propriedade Value, conforme indicado no trecho de código a seguir:

      public void  Enviar_Click(Object sender,EventArgs e)

                        Exibe.Value = Nome.Text  + "\n" + "Seus comentários:"

                                         +  "\n" + Comentários.Text;

IMPORTANTE! Você deve estar lembrado que nas versões anteriores do ASP, não podíamos “quebrar” um comando em várias linhas, sem colocar um caractere especial, no final de cada linha. Com ASP.NET, não temos mais esta limitação, observe que podemos dividir o comando em diversas linhas, sem maiores problemas.