HtmlInputCheckBox 伺服器控制項宣告式語法

發行項
08/12/2011

建立伺服器端控制項，使其對應到 <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 屬性。

注意事項
這個控制項不需要結尾標記。

範例

下列範例示範如何建立可以讓使用者選取 true 或 false 狀態的 HtmlInputCheckBox 控制項。當使用者按一下網頁上所包含的輸入按鈕時，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 伺服器控制項宣告式語法

備註

範例

請參閱

參考

其他資源

其他資源