Este controle é utilizado para a criação de controles do tipo “Botão de rádio”. Estes controles são criados em grupos, sendo que somente um dos controles do grupo pode ser selecionado. Para criar um grupo de controles do tipo RadioButton, devemos definir o mesmo valor para a propriedade GroupName, de todos os controles que fazem parte do grupo.

NOTA: Para criar múltiplos controles do tipo RadioButton, de uma só vez, ligados a uma fonte de dados, devemos utilizar o controle RadioButtonList. Aprenderemos a utilizar este controle nos Capítulos 10 e 11.

O Controle RadioButton Web Server Control é derivado da classe base RadioButton, do namespace System.Web.UI.WebControls.

A sintaxe para este controle é a seguinte:

<asp:RadioButton 

id="Identificação_no_código" 

AutoPostBack="True|False"

                        Checked="True|False"

GroupName="Nome do  Grupo."

Text="Rótulo de texto  que identifica o controle"

                        TextAlign="Right|Left"

OnCheckedChanged="Método  que será executado em resposta ao evento 

OnCheckedChanged"

                        runat="server"

/>

Considere o trecho de código a seguir:

<asp:RadioButton 

id="Cartão" 

            Text="Cartão de Crédito:" 

             Checked="True" 

             GroupName="GrupoPagamento" 

             runat="server" />

      <asp:RadioButton

           id="Transferência" 

           Text="Transferência  Eletrônica:" 

           GroupName="GrupoPagamento" 

           runat="server"/>

      <asp:RadioButton  id="Boleto"  

           Text="Boleto Bancário" 

           GroupName="GrupoPagamento" 

           runat="server"/>

Neste trecho criamos um grupo chamado GrupoPagamento, o qual possui três controles do tipo RadioButton:

• Cartão
• Transferência
• Boleto

Ao carregarmos a página, o controle Cartão já vem selecionado, pois definimos a sua propriedade Checked=”True”. Este trecho de código gera a saída indicada na Figura 9.4.

Figura 9.4 Grupo de Controles do tipo RadioButton – GrupoPagamento.

Para verificar qual a opção foi selecionada, podemos utilizar a propriedade Checked de cada controle, conforme indicado no seguinte trecho de código:

if (Cartão.Checked) 

          {

            Label1.Text = "Você selecionou: "  + Cartão.Text;

         }

else if (Transferência.Checked) 

          {

            Label1.Text = " Você  selecionou:" + Transferência.Text;

         }

else if (Boleto.Checked) 

          {

            Label1.Text = " Você selecionou:"  + Boleto.Text;

         }

Neste exemplo estamos definindo o texto a ser exibido em um controle do tipo Label (Label1), com base na opção selecionada. A propriedade Text do controle RadioButton (Cartão.Text, Transferência.Text e Boleto.Text), retorna o valor definido na propriedade Text do controle. Por exemplo, para o controle Cartão, Cartão.Text=”Cartão de Crédito:”.

NOTA: Para uma referência completa sobre todas as propriedades do controle RadioButton, consulte a documentação do Framework .NET. Mais especificamente, consulte a classe RadioButton do namespace System.Web.UI.WebControls.