Share via

Deklarative Syntax des HtmlInputCheckBox-Serversteuerelements

  • Artikel

Aktualisiert: November 2007

Erstellt ein serverseitiges Steuerelement, das dem <input type=checkbox>-HTML-Element zugeordnet wird und mit dem Sie ein Kontrollkästchensteuerelement erstellen können, über das Benutzer zwischen dem Zustand true und dem Zustand false auswählen können.

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

Hinweise

Verwenden Sie das HtmlInputCheckBox-Steuerelement, um das <input type=checkbox>-HTML-Element zu programmieren. Beim Klicken auf das HtmlInputCheckBox-Steuerelement findet kein Postback an den Server statt. Wenn Sie ein Steuerelement verwenden, das einen Postback an den Server durchführt, z. B. das HtmlInputButton-Steuerelement, wird der Zustand des Kontrollkästchens zur Verarbeitung an den Server gesendet. Um zu bestimmen, ob das Kontrollkästchen aktiviert ist, testen Sie die Checked-Eigenschaft des Steuerelements.

Tipp

Dieses Steuerelement erfordert kein Endtag.

Beispiel

Das folgende Beispiel veranschaulicht, wie ein HtmlInputCheckBox-Steuerelement erstellt wird, über das der Benutzer zwischen dem Zustand true und dem Zustand false auswählen kann. Wenn ein Benutzer auf die Eingabeschaltfläche in der Seite klickt, wird vom Button1_Click-Ereignishandler bestimmt, ob das HtmlInputCheckBox-Steuerelement aktiviert ist. Anschließend wird eine Meldung in einem <span>-Steuerelement angezeigt. Beachten Sie, dass der Benutzer zum Anzeigen des Texts immer noch auf Button1 klicken muss, auch wenn der checked-Wert in diesem Beispiel standardmäßig auf true festgelegt ist.

<%@ 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>

Siehe auch

Referenz

HtmlInputCheckBox

Weitere Ressourcen

HTML-Serversteuerelemente