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


<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" />

<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 控件在 Web 窗体页上创建复选框，该复选框允许用户在 true 或 false 状态之间切换。通过设置 Text 属性，可以指定要在该控件中显示的标题。标题可显示在复选框的右侧或左侧。设置 TextAlign 属性可以指定标题显示在哪一侧。

注意
由于 <asp:CheckBox> 元素没有内容，因此可以使用 /> 结束该标记，而不必使用单独的结束标记。

若要确定是否已选中 CheckBox 控件，请测试 Checked 属性。当 CheckBox 控件的状态在向服务器的各次发送过程间更改时，将引发 CheckedChanged 事件。可以为 CheckedChanged 事件提供事件处理程序，以便当 CheckBox 控件的状态在向服务器的各次发送过程间更改时执行特定的任务。

注意
在创建多个 CheckBox 控件时，还可以使用 CheckBoxList 控件。对于使用数据绑定创建一组复选框而言，CheckBoxList 控件更易于使用，而各 CheckBox 控件则使您可以更好地控制布局。

默认情况下，在单击 CheckBox 控件时不会自动向服务器发送窗体。若要启用自动发送，请将 AutoPostBack 属性设置为 true。

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

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

以下内容显示在 .aspx 文件中声明 CheckBox 控件的示例。复选框被设置为在选中时立即将窗体发送回服务器。

Visual Basic?	复制代码
<asp:CheckBox id=Check1 runat="server" Text="CheckBox 1" AutoPostBack="True"/>

C#?	复制代码
<asp:CheckBox id=Check1 runat="server" Text="CheckBox 1" AutoPostBack="True"/>

下面的示例演示如何创建 CheckedChanged 事件的事件处理程序，以便将包含客户付帐地址的文本框的内容复制到包含发货地址的文本框中。

Visual Basic?	复制代码
<%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> <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>

Visual Basic?

复制代码

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

<html>
<head>
<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>

C#?	复制代码
<%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> <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>

C#?

复制代码

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>

   <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

其他资源

Web 服务器控件语法

备注

示例

请参见

参考

其他资源