Visão geral sobre controles de Servidor RadioButtonList Web e RadioButton
O controle RadioButton e o controle RadioButtonList permitem que os usuários selecionem um pequeno conjunto de escolhas mutuamente excludentes predefinidas.
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:
Causar um postback de página quando um botão de opção estiver selecionado.
Capturar a interação do usuário quando um usuário seleciona um botão de opção.
Vincular cada botão de opção a dados a partir de um banco de dados.
Voltar ao topo
Segundo plano
Você pode usar dois tipos de controles de servidor Web para adicionar botões de opção a uma página da Web do ASP.NET: de individualRadioButton controles ou um RadioButtonList controle. Ambos os controles permitem que os usuários selecionem um pequeno conjunto de escolhas mutuamente excludentes predefinidas.Os controles permitem que você defina qualquer número de botões de opção com rótulos e organize-os horizontal ou verticalmente.
Você adiciona controles RadioButton individuais para uma página e trabalha com eles isoladamente.Normalmente, você agrupa dois ou mais botões individuais.Para obter mais informações, consulte Como: Adicionar individuais RadioButton Servidor Web controles a uma página Web Formulários.
Alternativamente, você pode usar o controle RadioButtonList, que é um único controle que atua como um controle pai para uma coleção de itens da lista de botões de opção.Ele deriva da classe base ListControl.Portanto, ele funciona muito semelhante aos controles ListBox, DropDownList, BulletedList e CheckBoxList de servidor Web.Muitos dos procedimentos para trabalhar com o controle RadioButtonList são os mesmos para outra lista de controles de servidor.
Ambos os tipos de controle têm vantagens.Usando controles RadioButton individuais, você obtém mais controle sobre o layout do grupo de botões de opção do que por meio do controle RadioButtonList.Por exemplo, você pode incluir texto não botão de opção entre botões de opção.
O controle RadioButtonList é uma opção melhor se você deseja criar um grupo de botões de opção com base nos dados de um fonte de dados.Também é um pouco mais fácil escrever código que determina qual botão foi selecionado.
.gif "Observação") Observação: |
|---|
Você também pode usar o HtmlInputRadioButton controle de servidor para adicionar botões de opção a uma página da Web do ASP.NET. Para obter mais informações, consulte HtmlInputRadioButton Servidor Controlar Declarative Syntax. |
Se você quiser apresentar aos usuários uma lista maior de opções ou uma lista que pode variar em comprimento em tempo de execução, use um controle de servidor Web ListBox ou DropDownList.
Agrupando botões de opção
Botões de opção são raramente usados sozinhos.Em vez disso, eles são agrupados para fornecer um conjunto de opções mutuamente exclusivas.Dentro de um grupo, apenas um botão de opção pode ser selecionado de cada vez.Você pode criar botões agrupados das seguintes maneiras:
Adicionar controles de servidor Web RadioButton individuais a uma página e, em seguida, manualmente atribuí-los todos para um grupo.O nome de grupo é arbitrário; todos os botões de opção com o mesmo nome de grupo são considerados parte de um único grupo.
Adicione um controle RadioButtonList de servidor Web à página.Os itens da lista no controle são agrupados automaticamente.
Eventos RadioButton e RadioButtonList
Eventos trabalham diferentemente entre controles RadioButton individuais e o controle RadioButtonList.
Controles individuais RadioButton
Controles RadioButton individuais invocam o evento CheckedChanged quando usuários clicam no controle.(Esse evento é herdado do controle CheckBox). 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 detalhes sobre como responder a este evento diretamente, consulte Como: Responder a uma seleção do usuário em um agrupar de RadioButton controle de servidor Web.
| 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 precisar criar um manipulador de eventos para o evento CheckedChanged.Você pode testar qual botão de opção está selecionada em qualquer código que executa como parte da página.Normalmente, você cria um manipulador de eventos para o evento CheckedChanged somente se você precisa saber que um botão de opção foi alterado, não apenas para ler a seleção atual.Para obter detalhes, consulte:Como: conjunto e obter a seleção em um controle do servidor RadioButton Web.
Controle RadioButtonList
O controle RadioButtonList gera um evento SelectedIndexChanged quando usuários alteram que botão de opção na lista está selecionado.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.Para obter detalhes, consulte:Como: Responder a alterações na lista de controles do servidor Web.
| 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 RadioButton individuais, é mais comum testar o estado do controle RadioButtonList 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.
Atributos de controle MTML RadioButton
Quando o RadioButton controle apresenta ao navegador, ele faz isso em duas partes: an input elemento que representa o botão de rádio e uma separada label elemento que representa a legenda do botão de opção. A combinação dos dois elementos é empacotada em um elemento span.
Quando você aplicar estilo ou atribuir configurações a um controle RadioButton, eles são aplicadas para o elemento span externo.Por exemplo, se você definir a propriedade BackColor de controle, a configuração é aplicada ao elemento span.Portanto, afeta ambos os elementos internos input e label.
Às vezes, convém fazer configurações separadas para o botão de opção e o rótulo.O controle RadioButton suporta duas propriedades qua você pode definir no tempo de execução.A propriedade InputAttributes deixa você adicionar atributos MTML para o elemento input, e a propriedade LabelAttributes deixa você adicionar atributos MTML 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 o botão de opção, mas não a legenda, mude de cor quando o usuário passar o ponteiro do mouse sobre ele.
RadioButton1.InputAttributes.Add("onmouseover", _
"this.style.backgroundColor = 'red'")
RadioButton1.InputAttributes.Add("onmouseout", _
"this.style.backgroundColor = 'white'")
RadioButton1.InputAttributes.Add("onmouseover",
"this.style.backgroundColor = 'red'");
RadioButton1.InputAttributes.Add("onmouseout",
"this.style.backgroundColor = 'white'");
Vinculando dados ao controle
Você pode ligar um controle RadioButton individual a uma fonte de dados, e você pode ligar qualquer propriedade do controle RadioButton de qualquer campo da fonte de dados.Por exemplo, você deve definir a propriedade Text de controle baseada na informação no banco de dados.
Como botões de opção são usados em grupos, vincular um único botão de opção a um fonte de dados é não um cenário comum.Em vez disso, é mais comum vincular um controle RadioButtonList a um fonte de dados.Nesse caso, a fonte de dados dinamicamente gera botões de opção (itens de lista) para cada registro na fonte de dados.
Voltar ao topo
Exemplos de código
Como: Adicionar servidor Web controles RadioButton a uma página de Web Forms
Como: Adicionar controles de servidor RadioButtonList Web a uma página de Web Forms
Como: conjunto e obter a seleção em um controle do servidor RadioButton Web
Como: conjunto layout em um controle de servidor Web RadioButtonList
Como: Responder a uma seleção do usuário em um agrupar de RadioButton controle de servidor Web
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 RadioButton e RadioButtonList.
Membro |
Descrição |
|---|---|
A classe principal para o controle RadioButton. |
|
A classe principal para o controle RadioButtonList. |
|
A classe que representa cada item no controle RadioButtonList. |
|
A coleção de itens que correspondem a itens individuais na lista para um controle RadioButtonList. |
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 de controles de CheckBox e CheckBoxList Web Server