Controllo server Web CheckBox
Crea una casella di controllo che consente all'utente di passare da uno stato true a uno stato false e viceversa.
<asp:CheckBox id="CheckBox1"
AutoPostBack="True|False"
Text="Label"
TextAlign="Right|Left"
Checked="True|False"
OnCheckedChanged="OnCheckedChangedMethod"
runat="server"/>
Osservazioni
Il controllo CheckBox crea una casella di controllo nella pagina Web Form che consente all'utente di passare da uno stato true a uno stato false e viceversa. Se si imposta la proprietà Text, è possibile specificare la didascalia da visualizzare nel controllo. La didascalia può essere visualizzata a destra o a sinistra della casella di controllo. Impostare la proprietà TextAlign per specificare il lato in cui inserire la didascalia.
Nota Poiché l'elemento <asp:CheckBox> è privo di contenuto, è possibile chiudere il tag con /> anziché utilizzare un tag di chiusura distinto.
Per determinare se il controllo CheckBox è selezionato, verificare la proprietà Checked. L'evento CheckedChanged viene generato se lo stato del controllo CheckBox cambia tra i diversi invii al server. È possibile creare un gestore eventi per l'evento CheckedChanged, per eseguire un'azione specifica quando lo stato del controllo CheckBox cambia tra i diversi invii al server.
Nota Quando si creano più controlli CheckBox, è inoltre possibile utilizzare il controllo CheckBoxList. Con il controllo CheckBoxList la creazione di un insieme di caselle di controllo mediante l'associazione dati risulta più semplice; il singolo controllo CheckBox consente invece un maggiore controllo sul layout.
Per impostazione predefinita, quando si fa clic sul controllo CheckBox, il form non viene inviato automaticamente al server. Per attivare l'invio automatico, impostare la proprietà AutoPostBack su true.
Attenzione Il testo non viene codificato in formato HTML prima di essere visualizzato nel controllo CheckBox. È pertanto possibile incorporare script all'interno dei tag HTML presenti nel testo. Se i valori del controllo provengono dall'input dell'utente, assicurarsi di convalidare tali valori per evitare problemi di protezione.
Per informazioni dettagliate sulle proprietà e sugli eventi del controllo server Web CheckBox vedere la documentazione di Classe CheckBox.
Esempio
Nell'esempio seguente viene mostrata una dichiarazione di controllo CheckBox in un file aspx. La casella di controllo è impostata per inviare immediatamente il form al server quando viene selezionata.
<asp:CheckBox id=Check1 runat="server"
Text="CheckBox 1"
AutoPostBack="True"/>
Nell'esempio seguente viene mostrato come creare un gestore eventi per l'evento CheckedChanged, per eseguire la copia del contenuto di una casella di testo che contiene l'indirizzo di fatturazione di un cliente in una casella di testo che contiene l'indirizzo di spedizione.
<%@ 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>