Compartilhar via


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

Quando o usuário seleciona um controle CheckBox, o controle cria um evento que pode ser respondido.

Observação:

The CheckBoxList controle gera eventos de forma diferente individuais CheckBox controles do. Para obter detalhes, consulte:Como: Determine the seleção in lista servidor Web Controls.

Você não precisa responder diretamente ao evento selecionado do controle CheckBox.Você reponde ao evento apenas se for importante saber quando o usuário alterou a seleção da caixa de seleção.Se você está apenas interessado em saber qual o estado da caixa de seleção, e não se a seleção mudou, você pode simplesmente testar a seleção após o formulário ter sido enviado para o servidor.Para obter detalhes, consulte:Como: Obter e conjunto um valor de controle de servidor Web CheckBox programaticamente.

Para responder a uma seleção em um controle caixa de seleção.

  • Crie um manipulador de eventos para o evento do controle CheckedChanged.

    Como padrão, o evento CheckedChanged não envia imediatamente os Formulários Web da página para o servidor.Em vez disso, o evento é disparado no código do servidor na próxima vez que o formulário for enviado.Para o evento CheckedChanged causar um envio imediato, defina a propriedade AutoPostBack do controle CheckBox como true.

    Observação:

    A capacidade de um controle CheckBox enviar para o servidor quando ele estiver marcado requer que o navegador tenha suporte a ECMAScript (jscript, javascript) e que o script esteja ativado no navegador do usuário.

    O seguinte exemplo exibe "True" ou "False" em um controle de servidores Web Label para mostrar as últimas mudanças em um controle CheckBox.

    Protected Sub CheckBox1_CheckedChanged(ByVal sender As _
       System.Object, ByVal e As System.EventArgs) Handles _
       CheckBox1.CheckedChanged
       Label1.Text = "CheckBox1 selection is: " & _
           CheckBox1.Checked.ToString()
    End Sub
    
    protected void CheckBox1_CheckedChanged(object sender, EventArgs e)
    {
       Label1.Text = "CheckBox1 selection is: " + CheckBox1.Checked.ToString();
    }
    

Consulte também

Referência

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