Share via


Sintaxis declarativa del control de servidor HtmlInputRadioButton

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

Crea un control del servidor que realiza se asigna al elemento HTML <input type=radio> y permite crear un botón de radio en una página Web.

<input
    Type="Radio"
    EnableViewState="False|True"
    Id="string"
    Visible="False|True"
    OnDataBinding="OnDataBinding event handler"
    OnDisposed="OnDisposed event handler"
    OnInit="OnInit event handler"
    OnLoad="OnLoad event handler"
    OnPreRender="OnPreRender event handler"
    OnServerChange="OnServerChange event handler"
    OnUnload="OnUnload event handler"
    runat="server"
    />

Comentarios

Utilice el control HtmlInputRadioButton para programar basándose en el elemento HTML <input type=radio>. Puede agrupar varios controles HtmlInputRadioButton estableciendo la propiedad Name en un valor común a todos los elementos <input type=radio> del grupo. Los botones de radio de un mismo grupo se excluyen mutuamente; sólo se puede seleccionar un botón de radio cada vez.

Nota

Este control no requiere una etiqueta de cierre.

El control HtmlRadioButton no devuelve los datos al servidor automáticamente. Deberá utilizar uno de los controles de botón, como HtmlInputButton, HtmlInputImage o HtmlButton, para devolver los datos al servidor. Puede programar basándose en el control HtmlRadioButton escribiendo un controlador para el evento ServerChange.

Nota

El evento ServerChange se genera únicamente para los botones de radio que cambian al estado activado.

Ejemplo

En el ejemplo siguiente se muestra cómo crear un controlador de eventos para el evento ServerChange del control HtmlRadioButton. El controlador de eventos determina qué botones de radio se activan y muestra la selección en un mensaje.

<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
<title>HtmlInputRadioButton Control</title>

   <script runat="server">
      Sub Server_Change(Source As Object, e As EventArgs)
         If Radio1.Checked = True Then
            Span1.InnerHtml = "Radio1 is checked"
         Else
            If Radio2.Checked = True Then
               Span1.InnerHtml = "Radio2 is checked"
            Else
               If Radio3.Checked = True Then
                  Span1.InnerHtml = "Radio3 is checked"
               End If
            End If
         End If
      End Sub
   </script>

</head>
<body>
   <form id="Form1" runat="server">

      <h3>HtmlInputRadioButton Sample</h3>

      <input type="radio" 
             id="Radio1" 
             name="Mode"
             onserverchange="Server_Change" 
             runat="server"/>
      Option 1<br />
      <input type="radio" 
             id="Radio2" 
             name="Mode"
             onserverchange="Server_Change" 
             runat="server"/>
      Option 2<br />
      <input type="radio" 
             id="Radio3" 
             name="Mode"
             onserverchange="Server_Change" 
             runat="server"/>
      Option 3
      <br />
      <span id="Span1" runat="server" />
      <br />
      <input type="submit" id="Button1" 
             value="Enter" 
             runat="server" />
   </form>
</body>
</html>
<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >

<head>
<title>HtmlInputRadioButton Control</title>

   <script runat="server">
      void Server_Change(object Source, EventArgs e) 
      {
         if (Radio1.Checked == true)
            Span1.InnerHtml = "Radio1 is checked";
         else if (Radio2.Checked == true)
            Span1.InnerHtml = "Radio2 is checked";
         else if (Radio3.Checked == true)
            Span1.InnerHtml = "Radio3 is checked";
      }
   </script>

</head>
<body>
   <form id="Form1" runat="server">

      <h3>HtmlInputRadioButton Sample</h3>

      <input type="radio" 
             id="Radio1" 
             name="Mode"
             onserverchange="Server_Change" 
             runat="server"/>
      Option 1<br />
      <input type="radio" 
             id="Radio2" 
             name="Mode"
             onserverchange="Server_Change" 
             runat="server"/>
      Option 2<br />
      <input type="radio" 
             id="Radio3" 
             name="Mode"
             onserverchange="Server_Change" 
             runat="server"/>
      Option 3
      <br />
      <span id="Span1" runat="server" />
      <br />
      <input type="submit" id="Button1" 
             value="Enter" 
             runat="server" />
   </form>
</body>
</html>

Vea también

Referencia

HtmlInputRadioButton

System.Web.UI.HtmlControls

Otros recursos

Controles de servidor HTML