Deklarative Syntax des HtmlInputCheckBox-Serversteuerelements
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
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.
Hinweis
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
<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
<span id="Span1" style="color:red" runat="server" />
<br />
<input type="button" id="Button1" value="Enter"
onserverclick="Button1_Click" runat="server"/>
</form>
</body>
</html>