通过

RadioButton Web 服务器控件声明性语法

  • 项目

更新：2007 年 11 月

在页上创建一个单选按钮。可将多个单选按钮分为一组以提供一组互相排斥的选项。

<asp:RadioButton
    AccessKey="string"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    Checked="True|False"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    GroupName="string"
    Height="size"
    ID="string"
    OnCheckedChanged="CheckedChanged event handler"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Text="string"
    TextAlign="Left|Right"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
/>

备注

RadioButton 服务器控件在 Web 窗体页上创建一个单选按钮。通过设置 Text 属性指定要在控件中显示的文本。该文本可显示在单选按钮的左侧或右侧。设置 TextAlign 属性以控制该文本显示在哪一侧。如果为每个 RadioButton 控件指定了相同的 GroupName，则可以将多个单选按钮分为一组。将单选按钮分为一组将只允许从该组中进行互相排斥的选择。

说明：

您还可以使用 RadioButtonList 控件。对于使用数据绑定创建一组单选按钮而言，RadioButtonList 控件更易于使用，而单个 RadioButton 控件则使您能够更好地控制布局。

若要确定 RadioButton 控件是否已选中，请测试 Checked 属性。

警告：

文本在 RadioButton 控件中显示之前并非 HTML 编码形式。这使得可以在文本中的 HTML 标记中嵌入脚本。如果控件的值是由用户输入的，请务必要对输入值进行验证以防止出现安全漏洞。

有关 RadioButton Web 服务器控件的属性和事件的详细信息，请参见 RadioButton 类文档。

示例

下面的示例演示如何使用 RadioButton 控件为用户提供一组互斥的选项。

<%@ 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>RadioButton Example</title>
<script language="VB" runat="server">

    Sub SubmitBtn_Click(Sender As Object, e As EventArgs)

        If Radio1.Checked Then
            Label1.Text = "You selected " & Radio1.Text
        ElseIf Radio2.Checked Then
            Label1.Text = "You selected " & Radio2.Text
        ElseIf Radio3.Checked Then
            Label1.Text = "You selected " & Radio3.Text
        End If
    End Sub

     </script>

 </head>
 <body>

     <h3>RadioButton Example</h3>

     <form id="form1" runat="server">

         <h4>Select the type of installation you want to perform:</h4>

         <asp:RadioButton id="Radio1" Text="Typical" Checked="True" GroupName="RadioGroup1" runat="server" /><br />

         This option installs the features most typically used.  <i>Requires 1.2 MB disk space.</i><br />

         <asp:RadioButton id="Radio2" Text="Compact" GroupName="RadioGroup1" runat="server"/><br />

         This option installs the minimum files required to run the product.  <i>Requires 350 KB disk space.</i><br />

         <asp:RadioButton id="Radio3" runat="server" Text="Full" GroupName="RadioGroup1" /><br />

         This option installs all features for the product.  <i>Requires 4.3 MB disk space.</i><br />

         <asp:button text="Submit" OnClick="SubmitBtn_Click" runat="server"/>

         <asp:Label id="Label1" font-bold="true" 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>RadioButton Example</title>
<script language="C#" runat="server">

         void SubmitBtn_Click(Object Sender, EventArgs e) {

             if (Radio1.Checked) {
                 Label1.Text = "You selected " + Radio1.Text;
             }
             else if (Radio2.Checked) {
                 Label1.Text = "You selected " + Radio2.Text;
             }
             else if (Radio3.Checked) {
                 Label1.Text = "You selected " + Radio3.Text;
             }
         }

     </script>

 </head>
 <body>

     <h3>RadioButton Example</h3>

     <form id="form1" runat="server">

         <h4>Select the type of installation you want to perform:</h4>

         <asp:RadioButton id="Radio1" Text="Typical" Checked="True" GroupName="RadioGroup1" runat="server" /><br />

         This option installs the features most typically used.  <i>Requires 1.2 MB disk space.</i><br />

         <asp:RadioButton id="Radio2" Text="Compact" GroupName="RadioGroup1" runat="server"/><br />

         This option installs the minimum files required to run the product.  <i>Requires 350 KB disk space.</i><br />

         <asp:RadioButton id="Radio3" runat="server" Text="Full" GroupName="RadioGroup1" /><br />

         This option installs all features for the product.  <i>Requires 4.3 MB disk space.</i><br />

         <asp:button text="Submit" OnClick="SubmitBtn_Click" runat="server"/>

         <asp:Label id="Label1" font-bold="true" runat="server" />

     </form>

 </body>
 </html>

请参见

参考

RadioButton

其他资源

Web 服务器控件语法