Декларативный синтаксис серверного веб-элемента управления RadioButton

Статья
11/16/2008

Обновлен: Ноябрь 2007

Создает на странице переключатель. Допускается объединение нескольких переключателей в группу для предоставления набора взаимоисключающих вариантов выбора.

 <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 Forms. Текст, отображаемый в элементе управления , можно задать с помощью свойства Text. Текст может располагаться справа или слева от переключателя. Свойство TextAlign задает расположение текста. Указание одного и того же GroupName для всех элементов управления RadioButton позволяет создать группу переключателей. Объединение переключателей в группу предоставляет набор взаимоисключающих вариантов выбора.

Примечание.
Также можно использовать элемент управления RadioButtonList. Элемент управления RadioButtonList упрощает создание набора переключателей с помощью привязки данных, в то время как использование отдельных элементов управления RadioButton предоставляет большие возможности по управлению структурой.

Также можно использовать элемент управления RadioButtonList. Элемент управления RadioButtonList упрощает создание набора переключателей с помощью привязки данных, в то время как использование отдельных элементов управления RadioButton предоставляет большие возможности по управлению структурой.

Чтобы определить, установлен ли переключатель RadioButton, нужно проверить свойство Checked.

Внимание!
Перед отображением в элементе управления RadioButton текст не преобразуется в формат HTML. Это позволяет внедрять в текст сценарий, заключенный в теги HTML. Если значения элемента управления вводятся пользователем, их следует проверять на допустимость, чтобы избежать появления слабых мест в системе безопасности.

Перед отображением в элементе управления RadioButton текст не преобразуется в формат HTML. Это позволяет внедрять в текст сценарий, заключенный в теги HTML. Если значения элемента управления вводятся пользователем, их следует проверять на допустимость, чтобы избежать появления слабых мест в системе безопасности.

Подробные сведения о свойствах и событиях серверного веб-элемента управления RadioButton см. в документации класса 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

Другие ресурсы

Синтаксис серверного веб-элемента управления

Поделиться через