Deklarative Syntax des CheckBox-Webserversteuerelements
Aktualisiert: November 2007
Erstellt ein Kontrollkästchen, mit dem Benutzer zwischen den Zuständen true und false umschalten können.
<asp:CheckBox
AccessKey="string"
AutoPostBack="True|False"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CausesValidation="True|False"
Checked="True|False"
CssClass="string"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
OnCheckedChanged="CheckedChanged event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Style="string"
TabIndex="integer"
Text="string"
TextAlign="Left|Right"
ToolTip="string"
ValidationGroup="string"
Visible="True|False"
Width="size"
/>
Hinweise
Mit dem CheckBox-Steuerelement wird ein Kontrollkästchen auf der Web Forms-Seite erstellt, mit dem Benutzer zwischen den Zuständen true und false umschalten können. Sie können die Beschriftung angeben, die auf dem Steuerelement angezeigt werden soll, indem Sie die Text-Eigenschaft festlegen. Die Beschriftung kann rechts oder links vom Kontrollkästchen angezeigt werden. Legen Sie die TextAlign-Eigenschaft fest, um die Seite anzugeben, auf der die Beschriftung angezeigt werden soll.
Tipp
Da das <asp:CheckBox>-Element keinen Inhalt enthält, können Sie das Tag anstatt mit einem separaten Endtag mit /> schließen.
Um festzustellen, ob das CheckBox-Steuerelement aktiviert ist, überprüfen 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.
Tipp
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. Legen Sie die AutoPostBack-Eigenschaft auf true fest, um automatische Übermittlung zu aktivieren.
Warnung
Text wird erst dann HTML-codiert, wenn 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 validiert werden, um die Sicherheit zu gewährleisten.
Ausführliche Informationen zu den Eigenschaften und Ereignissen von CheckBox-Webserversteuerelementen finden Sie in der Dokumentation zur CheckBox-Klasse.
Beispiel
Das folgende Beispiel zeigt eine Beispieldeklaration für ein CheckBox-Steuerelement in einer ASPX-Datei. 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"/>
<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 Textfelds mit der Rechnungsadresse eines Kunden in ein Textfeld mit der Versandadresse des Kunden zu kopieren.
.gif "Sicherheitshinweis") Sicherheitshinweis: |
|---|
Dieses Beispiel enthält ein Textfeld, das eine Benutzereingabe akzeptiert. Diese stellt ein potenzielles Sicherheitsrisiko dar. Standardmäßig stellt die ASP.NET-Seite sicher, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe. |
<%@ 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 runat="server">
<title>CheckBox Web Server Control Declarative Syntax</title>
<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 id="form1" 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>
<%@ 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 runat="server">
<title>CheckBox Example</title>
<script runat="server">
void Check_Clicked(Object sender, EventArgs e)
{
if(SameCheckBox.Checked)
ShipTextBox.Text = BillTextBox.Text;
else
ShipTextBox.Text = "";
}
</script>
</head>
<body>
<form id="form1" 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>