HtmlInputCheckBox 服务器控件声明性语法

  • 项目

[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

创建服务器端控件，该控件映射到 <input type=checkbox> HTML 元素并允许您创建使用户可以选择 true 或 false 状态的复选框控件。

<input
    Type="Checkbox"
    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"
    />

备注

使用 HtmlInputCheckBox 控件对 <input type=checkbox> HTML 元素进行编程。 单击 HtmlInputCheckBox 控件时，该控件不会向服务器回送。 当使用回送服务器的控件（如 HtmlInputButton 控件）时，复选框的状态被发送到服务器进行处理。 若要确定是否选中了复选框，请测试控件的 Checked 属性。

备注

此控件不需要结束标记。

示例

下面的示例演示如何创建 HtmlInputCheckBox 控件来允许用户选择 true 或 false 状态。 当用户单击页上包含的输入按钮时，Button1_Click 事件处理程序确定是否选中了 HtmlInputCheckBox 控件。 然后，它在 <span> 控件中显示一个消息。 请注意，即使此例中在默认情况下将选中的值设置为 true，用户仍然需要单击 Button1 以显示该文本。

<%@ 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>HtmlInputCheckBox Control</title>

   <script runat="server">
      Sub Button1_Click(Source As Object, e As EventArgs)
         If Check1.Checked = True Then
            Span1.InnerHtml = "Check1 is checked!"
         Else
            Span1.InnerHtml = "Check1 is not checked!"
         End If
      End Sub
   </script>

</head>
<body>

    <h3>HtmlInputCheckBox Sample</h3>

    <form id="Form1" runat="server">
        <input id="Check1" type="checkbox" runat="server" checked="checked"/> 
            CheckBox1 &nbsp;&nbsp;
        <span id="Span1" style="color:red" runat="server" />
        <br />
        <input type="button" id="Button1" value="Enter"
               onserverclick="Button1_Click" 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>HtmlInputCheckBox Control</title>

    <script runat="server">
       void Button1_Click(object Source, EventArgs e) 
       {
          if (Check1.Checked == true) 
          {
             Span1.InnerHtml = "Check1 is checked!";
          }
          else 
          {
             Span1.InnerHtml = "Check1 is not checked!";
          }
       }
    </script>

</head>
<body>

    <h3>HtmlInputCheckBox Sample</h3>

    <form id="Form1" runat="server">
        <input id="Check1" type="checkbox" runat="server" checked="checked"/> 
            CheckBox1 &nbsp;&nbsp;
        <span id="Span1" style="color:red" runat="server" />
        <br />
        <input type="button" id="Button1" value="Enter"
               onserverclick="Button1_Click" runat="server"/>
    </form>
</body>
</html>

请参见

参考

HtmlInputCheckBox

其他资源

HTML 服务器控件