Controle CheckBoxList do ASP.NET
Definição e uso
O CheckBoxList é usado para criar grupos de caixas de seleção de múltipla escolha.
Cada opção no CheckBoxList é definida pelo elemento ListItem!
Dica:Este controle suporta ligação de dados!
Atributo
| Atributo | Descrição | .NET |
|---|---|---|
| PreenchimentoDeCélula | Número de pixels entre a borda da célula e o conteúdo. | 1.0 |
| EspaçamentoDeCélula | Número de pixels entre as células da tabela. | 1.0 |
| ColunasDeRepetição | Número de colunas usado ao exibir o grupo de caixas de seleção. | 1.0 |
| DireçãoDeRepetição | Determina se o grupo de caixas de seleção repetirá horizontalmente ou verticalmente. | 1.0 |
| RepetirLayout | Layout do grupo de caixas de seleção. | 1.0 |
| runat | Determina que o controle é um controle do servidor. Deve ser configurado como "server". | 1.0 |
| AlinhamentoDeTexto | Texto aparecendo do lado do campo de caixa de seleção. | 1.0 |
Atributos Padrão do ControlList
AdicionarItensApósDadoLigado, RetornarAutomaticamente, CausarValidação, CampoDeTextoDeDado, FormatoDeTextoDeDado, CampoDeValorDeDado, Itens, runat, ÍndiceSelecionado, ItemSelecionado, ValorSelecionado, ChaveDeTag, Texto, GrupoDeValidação, AoMudarSelecionado
O ControlList inclui todas as funcionalidades básicas de controles de lista. Controles que herdam deste controle incluem: CheckBoxList, DropDownList, ListBox e RadioButtonList.
Para uma descrição completa, acesse Atributos Padrão do ControlList.
Propriedades Padrão de Controle Web
Chave de Acesso, Atributos, Cor de Fundo, Cor da Borda, Estilo da Borda, Largura da Borda, CssClass, Habilitado, Fonte, Ativar Tema, Cor de Fundo, Altura, Habilitado, SkinID, Style, TabIndex, ToolTip, Largura
Para uma descrição completa, acesse Propriedades Padrão de Controle Web.
Propriedades Padrão de Controle
AppRelativeTemplateSourceDirectory, BindingContainer, ClientID, Controls, EnableTheming, EnableViewState, ID, NamingContainer, Page, Parent, Site, TemplateControl, TemplateSourceDirectory, UniqueID, Visible
Para uma descrição completa, acessePropriedades Padrão de Controle.
Exemplo
- CheckBoxList
- Neste exemplo, declaramos um controle CheckBoxList no arquivo .aspx. Em seguida, criamos um gerenciador de evento para o evento SelectedIndexChanged. Esta lista opcional contém seis caixas de seleção. Quando o usuário selecionar uma delas, a página será automaticamente enviada ao servidor e executará o subrotina Check. Esta subrotina percorrerá a coleção Items do controle e testará a propriedade Selected de cada item. Os itens selecionados serão exibidos no controle Label.
