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

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

  • Статья

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

Создает элемент управления "флажок", позволяющий пользователю устанавливать состояния true и false.

<asp:CheckBox
    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"
    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"
/>

Заметки

Элемент управления CheckBox создает на странице веб-форм флажок, позволяющий пользователю устанавливать состояние true и false. Можно задать надпись, отображаемую в элементе управления, с помощью свойства Text. Эта надпись может располагаться справа или слева от флажка. Свойство TextAlign задает расположение надписи.

4s78d0k1.alert_note(ru-ru,VS.90).gifПримечание.

Поскольку элемент <asp:CheckBox> не имеет содержимого, можно закрыть тег с помощью /> вместо использования отдельного закрывающего тега.

Чтобы определить, выбран ли элемент управления CheckBox следует проверить свойство Checked. Событие CheckedChanged вызывается при изменении состояния элемента управления CheckBox в промежутках времени между запросами на сервер. Можно предоставить обработчик событий для события CheckedChanged для выполнения определенной задачи, когда состояние элемента управления CheckBox изменяется в промежутках времени между запросами на сервер.

4s78d0k1.alert_note(ru-ru,VS.90).gifПримечание.

При создании нескольких элементов управления CheckBox можно использовать также элемент управления CheckBoxList. Элемент управления CheckBoxList проще использовать, когда нужно создать набор флажков с помощью связывания данных, в то время как отдельные элементы управления CheckBox дают большие возможности управления макетом.

По умолчанию при установке элемента управления CheckBox не выполняется автоматическая отправка формы на сервер. Чтобы включить автоматическую отправку, установите для свойства AutoPostBack значение true.

4s78d0k1.alert_caution(ru-ru,VS.90).gifВнимание!

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

Дополнительные сведения о свойствах и событиях серверного веб-элемента управления CheckBox см. в документации класса CheckBox.

Пример

В следующем примере показано объявление в файле .aspx для элемента управления CheckBox. Флажок устанавливается для немедленной отправки формы на сервер после его выбора.

<asp:CheckBox id="Check1" runat="server"
     Text="CheckBox 1"
     AutoPostBack="True"/>

<asp:CheckBox id="Check1" runat="server"
     Text="CheckBox 1"
     AutoPostBack="True"/>

В следующем примере показано, как создать обработчик событий для события CheckedChanged, чтобы копировать содержимое текстового поля, содержащего расчетный адрес заказчика, в текстовое поле, содержащее адрес поставки.

4s78d0k1.alert_security(ru-ru,VS.90).gifПримечание о безопасности.

В данном примере представлено текстовое поле для ввода пользовательских данных, которые представляют потенциальную угрозу безопасности. По умолчанию веб-страницы ASP.NET проверяют введенные пользователем данные на наличие сценариев и элементов HTML. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.

 
<%@ 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 runat="server">
<title>CheckBox Web Server Control Declarative Syntax</title>

   <script runat="server">

      Sub Check_Clicked(sender As Object, e As EventArgs) 

         If SameCheckBox.Checked Then
            ShipTextBox.Text = BillTextBox.Text
         Else
            ShipTextBox.Text = ""
         End If

      End Sub

   </script>

</head>

<body>

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

      <h3>CheckBox Example</h3>








      <table>
         <tr>
            <td>
               Billing Address: <br />
               <asp:TextBox id="BillTextBox"
                    TextMode="MultiLine"
                    Rows="5" 
                    runat="server"/>
            </td>
            <td>
               Shipping Address: <br />
               <asp:TextBox id="ShipTextBox"
                    TextMode="MultiLine"
                    Rows="5" 
                    runat="server"/>
            </td>
         </tr>
         <tr>
            <td>
            </td>
            <td>
               <asp:CheckBox id="SameCheckBox"
                    AutoPostBack="True"
                    Text="Same as billing."
                    TextAlign="Right"
                    OnCheckedChanged="Check_Clicked"
                    runat="server"/>
            </td>
         </tr>
      </table>


   </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 runat="server">
    <title>CheckBox Example</title>
<script runat="server">

      void Check_Clicked(Object sender, EventArgs e) 
      {
         if(SameCheckBox.Checked)
            ShipTextBox.Text = BillTextBox.Text;
         else
            ShipTextBox.Text = "";
      }

   </script>

</head>

<body>

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

      <h3>CheckBox Example</h3>








      <table>
         <tr>
            <td>
               Billing Address: <br />
               <asp:TextBox id="BillTextBox"
                    TextMode="MultiLine"
                    Rows="5" 
                    runat="server"/>
            </td>
            <td>
               Shipping Address: <br />
               <asp:TextBox id="ShipTextBox"
                    TextMode="MultiLine"
                    Rows="5" 
                    runat="server"/>
            </td>
         </tr>
         <tr>
            <td>
            </td>
            <td>
               <asp:CheckBox id="SameCheckBox"
                    AutoPostBack="True"
                    Text="Same as billing."
                    TextAlign="Right"
                    OnCheckedChanged="Check_Clicked"
                    runat="server"/>
            </td>
         </tr>
      </table>


   </form>

</body>
</html>

См. также

Ссылки

CheckBox

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

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