CheckBox-Webserversteuerelement
Erstellt ein Kontrollkästchen, in dem der Benutzer zwischen dem Status true oder false umschalten kann.
<asp:CheckBox id="CheckBox1"
AutoPostBack="True|False"
Text="Label"
TextAlign="Right|Left"
Checked="True|False"
OnCheckedChanged="OnCheckedChangedMethod"
runat="server"/>
Hinweise
Mit dem CheckBox-Steuerelement wird ein Kontrollkästchen auf der Web Forms-Seite erstellt, in dem der Benutzer zwischen dem Status true oder false umschalten kann. Sie können die Beschriftung angeben, die auf dem Steuerelement angezeigt werden soll, indem Sie die Text-Eigenschaft setzen. Die Beschriftung kann rechts oder links vom Kontrollkästchen angezeigt werden. Setzen Sie die TextAlign-Eigenschaft, um anzugeben, auf welcher Seite die Beschriftung erscheinen soll.
Hinweis Da das <asp:CheckBox>-Element keinen Inhalt hat, können Sie das Tag mit /> abschließen, anstatt ein separates schließendes Tag zu verwenden.
Um zu ermitteln, ob das CheckBox-Steuerelement aktiviert ist, testen Sie die Checked-Eigenschaft. Das CheckedChanged-Ereignis wird ausgelöst, wenn der Status des CheckBox-Steuerelements sich zwischen Übermittlungen an den Server ändert. Sie können einen Ereignishandler für das CheckedChanged-Ereignis bereitstellen, damit eine bestimmte Aufgabe ausgeführt wird, wenn sich der Status des CheckBox-Steuerelements zwischen Übermittlungen an den Server ändert.
Hinweis Wenn Sie mehrere CheckBox-Steuerelemente erstellen, können Sie auch das CheckBoxList-Steuerelement verwenden. Das CheckBoxList-Steuerelement eignet sich besser zum Erstellen einer Gruppe von Kontrollkästchen mit Datenbindung, während Sie bei einem einzelnen CheckBox-Steuerelement mehr Möglichkeiten für die Layoutgestaltung haben.
Standardmäßig sendet das CheckBox-Steuerelement nicht automatisch das Formular an den Server, wenn darauf geklickt wird. Um die automatische Übermittlung zu aktivieren, setzen Sie die AutoPostBack-Eigenschaft auf true.
Vorsicht Text wird nicht in HTML codiert, bevor er im CheckBox-Steuerelement angezeigt wird. Auf diese Weise können Skripts in HTML-Tags in den Text eingebunden werden. Wenn die Werte in diesem Steuerelement aus Benutzereingaben stammen, müssen die Werte unbedingt geprüft werden, um die Sicherheit zu gewährleisten.
Weitere Informationen zu den Eigenschaften und Ereignissen des CheckBox-Webserversteuerelements finden Sie unter CheckBox-Klasse.
Beispiel
Das folgende Beispiel veranschaulicht, wie ein CheckBox-Steuerelement in einer ASPX-Datei deklariert wird. Das Kontrollkästchen ist so eingestellt, dass es das Formular sofort an den Server zurücksendet, sobald es aktiviert wird.
<asp:CheckBox id=Check1 runat="server"
Text="CheckBox 1"
AutoPostBack="True"/>
Im folgenden Beispiel wird gezeigt, wie Sie einen Ereignishandler für das CheckedChanged-Ereignis erstellen, um den Inhalt eines Textfeldes für die Rechnungsadresse eines Kunden in ein Textfeld für die Versandadresse des Kunden zu kopieren.
<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
<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 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 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>