A classe WebControl, do namespace System.Web.UI.WebControls é a classe da qual são derivados os controles que iremos estudar nesta capítulo. Esta classe defini os métodos, eventos e propriedades comuns a todos os controles pertencentes ao namespace System.Web.UI.WebControls. Por serem derivados da classe WebControl, estes controles irão herdar suas propriedades e métodos públicos. Estudaremos as principais propriedades e métodos da classe WebControl.
Principais propriedades da classe WebControl
Na Tabela 9.1 temos a descrição das principais propriedades da classe WebControl.
| Propriedade |
Descrição |
| AccessKey |
É utilizada para definir ou retornar uma combinação de teclas (tecla de atalho) utilizada para colocar o foco no controle. |
| BackColor |
É utilizada para definir ou retornar a cor de segundo plano, do controle. |
| BorderColor |
É utilizada para definir ou retornar a cor das bordas do controle. |
| BorderStyle |
É utilizada para definir ou retornar o estilo das bordas do controle. |
| BorderWidth |
É utilizada para definir ou retornar a largura das bordas do controle. |
| ControlStyle |
É utilizada para definir ou retornar o estilo (aspectos visuais) do controle, como por exemplo: com ou sem preenchimento, com sombra, etc. |
| Enabled |
Propriedade do tipo Boleana (True ou False), utilizada para definir ou retornar um valor que indica se o controle está habilitado: True = habilitado e False=desabilitado. |
| EnableViewState |
Propriedade do tipo Boleana (True ou False), utilizada para definir ou retornar um valor que indica se o controle de estado está habilitado (True) ou desabilitado (False). |
| Font |
Retorna informações sobre a fonte utilizada para o controle. |
| ForeColor |
É utilizada para definir ou retornar informações sobre a cor do texto do controle. |
| Height |
É utilizada para definir ou retornar a altura do controle. |
| Style |
Faz referência a uma coleção de propriedades do tipo CSS – Cascading Style Sheets, associadas com o controle. |
| TabIndex |
É utilizada para definir ou retornar informações sobre o índice de tabulação do controle. O índice de tabulação define a ordem de deslocamento do cursor, dentro de um formulário, quando pressionamos a tecla TAB. Por exemplo, se estamos em um campo com índice de tabulação 2 e pressionamos a tecla TAB, o cursor irá para o controle com índice de tabulação 3. |
| ToolTip |
É utilizada para definir ou retornar um pequeno texto que será exibido quando o usuário apontar o mouse para o controle. |
| Visible |
Propriedade boleana, utilizada para retornar ou definir um valor que indica se o controle deve ser exibido (True) ou não (False). |
| Width |
É utilizada para definir ou retornar a largura do controle. |
Tabela 9.1 Propriedades da classe WebControl.
Estas propriedades estão disponíveis para todos os controles derivados da classe WebControl, em outras palavras, os controles que tem a classe WebControl como base, irão herdar estas propriedades.
Principais métodos da classe WebControl.
Na Tabela 9.2 temos a descrição dos principais métodos da classe WebControl.
| Método |
Descrição |
| CopyBaseAttributes |
Copia o valor das propriedades AccessKey, Enabled, TabIndex e Attributes para o controle atual, a partir de um controle especificado como parâmetro para o método. É semelhante ao que faz a ferramenta pincel nos aplicativos do Microsoft Office, quando copia uma série de características de formatação de um parágrafo para outro. |
| DataBind |
Faz a associação de uma fonte de dados com o controle e com todos os seus controles filhos. |
| Equals |
Determina se duas instâncias de um controle, são iguais. |
| FindControl |
Procura um determinado controle no Container atual. Normalmente o Container atual é a página ASP.NET onde está o controle. |
| HasControls |
Retorna um valor Boleano indicando se o controle possui controles filhos (True) ou não (False). |
| ToString |
Retorna uma representação do controle, no formato string. |
Tabela 9.2 Métodos da classe WebControl.
Principais eventos da classe WebControl.
Na Tabela 9.3 temos a descrição dos principais eventos da classe WebControl.
| Evento |
Descrição |
| DataBinding |
Ocorre quando o controle é ligado (associado) a uma fonte de dados. |
| Disposed |
Ocorre quando o controle é descarregado da memória, o qual é o último estágio no ciclo de vida do controle quando a página ASP.NET é carregada. |
| Init |
Ocorre quando o controle é inicializado, o que é o primeiro estágio no seu ciclo de vida. |
| Load |
Ocorre quando o objeto, que representa uma instância do controle, é carregado no objeto Page, que representa a página sendo carregada. Lembre que toda página ASP.NET ao ser carregada é compilada em um objeto que é uma instância da classe Page. |
Tabela 9.3 Eventos da classe WebControl.
Agora vamos passar ao estudo de cada controle, individualmente. |
Júlio Battisti tem mais de 50 livros publicados, centenas de e-books e é certificado Microsoft.
