Visão geral de controles de CheckBox e CheckBoxList Web Server

O controle CheckBox e o controle CheckBoxList fornecem um meio para os usuários especificarem escolhas sim/não (verdadeiro/falso).

Esse tópico contém:

  • Recursos

  • Segundo plano

  • Exemplos de código

  • Referência de Classe

Recursos

Você pode usar o controle CheckBox e o controle CheckBoxList para:

  • Produzir uma página postback quando uma caixa de seleção está selecionada.

  • Capturar interação do usuário quando um usuário seleciona um caixa de seleção.

  • Ligar cada caixa de seleção ao dado do banco de dados.

Voltar ao topo

Segundo plano

Você pode usar dois tipos de controles de servidor Web para adicionar caixas de seleção a uma página da Web do ASP.NET: de individualCheckBox controles ou um CheckBoxList controle. Ambos os controles fornecem um meio para os usuário especificarem escolhas sim/não (verdadeiro/falso).

Você adiciona controles CheckBox individuais para uma página e trabalha com eles isoladamente.Alternativamente, você pode usar o controle CheckBoxList, que é o único controle que atua como um controle pai para uma coleção de itens da lista de caixas de seleção.Deriva da classe ListControl base, e, por isso, funciona bastante como o ListBox, DropDownList, RadioButtonList, e BulletedList controles de servidor Web.Muitos dos procedimentos para trabalhar com o controle CheckBoxList são os mesmos para outra lista de controles de servidor.

Ambos os tipos de controles têm vantagens.Usando controles CheckBox individuais, você obtém mais controle sobre o layout das caixas de seleção na página do que por meio do controle CheckBoxList.Por exemplo, você pode incluir uma caixa de texto não selecionada entre cada caixa de seleção.Você pode também controlar a fonte e a cor de caixas de seleção individuais.

O controle CheckBoxList é uma escolha melhor se você desejar criar uma série de caixas de seleção a partir de dados em um banco de dados.(Você pode ligar um controle CheckBox individual ao dado.)

Observação:

Você também pode usar o controle HtmlInputCheckBox para adicionar caixas de seleção a um página de Formulários Web.Para obter mais informações, consulte HtmlInputCheckBox Servidor Controlar Declarative Syntax.

Eventos de Caixa de Seleção e Lista de Caixas de Seleção

Eventos trabalham diferentemente entre controles CheckBox individuais e o controle CheckBoxList.

Eventos do Controle de Caixa de Seleção

Controles CheckBox individuais invocam o evento CheckedChanged quando usuários clicam no controle.Por padrão, esse evento não ocasiona a página ser postada no servidor.Entretanto, você pode forçar o controle a executar um postback imediato pela configuração da propriedade AutoPostBack para true.Para obter mais informações, consulte Como: Responder a seleção do usuário em um controle de servidor Web CheckBox.

Observação:

A capacidade autopostback requer que o navegador tenha suporte a ECMAScript (JScript, JavaScript) e que o script esteja ativado no navegador do usuário.

Você pode não precisar criar um manipulador de eventos para o CheckedChanged evento.Você pode testar qual caixa de seleção está selecionada em qualquer código que executa como parte da página.Tipicamente, você cria um manipulador de evento para o CheckedChanged evento apenas se você precisar saber qual caixa de seleção foi modificada, não apenas para ler o valor da caixa de seleção.Para obter detalhes, consulte:Como: conjunto e obter a seleção em um controle do servidor RadioButton Web.

Eventos de Controle de Lista de Caixa de Seleção

O controle CheckBoxList invoca um eventoSelectedIndexChanged quando usuários selecionam qualquer caixa de seleção na lista.Por padrão, o evento não ocasiona a página ser postada no servidor.Entretanto, você pode forçar o controle a executar um postback imediato pela configuração da propriedade AutoPostBack para true.

Observação:

A capacidade autopostback requer que o navegador tenha suporte a ECMAScript (JScript, JavaScript) e que o script esteja ativado no navegador do usuário.

Assim como controles CheckBox individuais, é mais comum testar o estado do controle CheckBoxList depois de a página ser postada de alguma outra forma.Para obter detalhes, consulte:Como: Determine the seleção in lista servidor Web Controls.

CheckBox controla atributos HTML

Quando o CheckBox controle apresenta ao navegador, ele faz isso em duas partes: an input elemento que representa a caixa de seleção e uma separada label elemento que representa a legenda para a caixa de seleção. A combinação dos dois elementos é empacotada em um elemento span.

Quando você aplicar estilo ou configurações de atributo a um controle CheckBox , as configurações são aplicadas para o elemento de intervalo externo.Por exemplo, se você definir a propriedade BackColor de controle, a configuração é aplicada ao elemento span.Portanto, afeta ambos os atributos, o interno input e os label.

Às vezes, você pode querer aplicar configurações separadas para a caixa de seleção e para a legenda.O controle CheckBox suporta duas propriedades qua você pode definir no tempo de execução.A propriedade InputAttributes deixa você adicionar atributos HTML para o elemento input , e a propriedade LabelAttributes deixa você adicionar atributos HTML para o elemento label.Os atributos que você definir são passados completamente como são para o navegador.O exemplo seguinte mostra como definir atributos para o elemento input a fim de que apenas a caixa de seleção, mas não a legenda, mude de cor quando o usuário passar o ponteiro do mouse sobre ele.

[Visual Basic]

CheckBox1.InputAttributes.Add("onmouseover", _
    "this.style.backgroundColor = 'red'")
CheckBox1.InputAttributes.Add("onmouseout", _
    "this.style.backgroundColor = 'white'")
CheckBox1.InputAttributes.Add("onmouseover", 
    "this.style.backgroundColor = 'red'");
CheckBox1.InputAttributes.Add("onmouseout", 
    "this.style.backgroundColor = 'white'");

Ligando Dados aos Controles

Você pode ligar um controle CheckBox individual a uma fonte de dados, e você pode ligar qualquer propriedade do controle CheckBox de qualquer campo da fonte de dados.Por exemplo, você tipicamente define a propriedade Checked de controle baseada na informação no banco de dados.

Você também pode vincular um controle CheckBoxList a uma fonte de dados.Nesse caso, cada caixa de seleção representa um registro diferente na fonte de dados.

Voltar ao topo

Exemplos de código

Como: Adicionar controles de servidor Web CheckBox a uma página de Web Forms

Como: Adicionar controles de servidor Web CheckBoxList a uma página de Web Forms

Como: conjunto layout em um controle de servidor Web CheckBoxList

Como: Obter e conjunto um valor de controle de servidor Web CheckBox programaticamente

Como: Responder a seleção do usuário em um controle de servidor Web CheckBox

Como: Adicionar itens em controles de lista do servidor Web

Como: popular a lista servidor Web controles a partir de fontes de dados

Como: Responder a alterações na lista de controles do servidor Web

Voltar ao topo

Referência de Classe

A tabela seguinte lista as classes que se referem aos controles CheckBox e CheckBoxList.

Membro

Descrição

CheckBox

A classe principal para o controle CheckBox.

CheckBoxList

A classe principal para o controle CheckBoxList.

ListItem

A classe que representa cada item no controle CheckBoxList.

Items

A coleção de itens que correspondem a itens individuais na lista para um controle CheckBoxList.

Voltar ao topo

Consulte também

Tarefas

Como: conjunto a seleção em controles de lista do servidor Web

Como: Determine the seleção in lista servidor Web Controls

Referência

Visão geral sobre controles de Servidor RadioButtonList Web e RadioButton