Sintassi dichiarativa per il controllo server Web CheckBox

Articolo
09/12/2008

Aggiornamento: novembre 2007

Crea una casella di controllo che consente all'utente di passare da uno stato true a uno stato false e viceversa.

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

Note

Il controllo CheckBox crea una casella di controllo sulla pagina Web Form che consente all'utente di passare da uno stato true a uno stato false e viceversa. Impostando 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> non ha contenuto, è possibile chiudere il tag con /> invece di utilizzare un tag di chiusura distinto.

Per determinare se il controllo CheckBox è selezionato, eseguire il test della proprietà Checked. L'evento CheckedChanged viene generato se lo stato del controlloCheckBox cambia tra un invio e l'altro al server. È possibile creare un gestore eventi per l'evento CheckedChanged per eseguire un'azione specifica quando lo stato del controllo CheckBox cambia tra un invio e l'altro al server.

Nota

Quando si creano più controlli CheckBox, è inoltre possibile utilizzare il controllo CheckBoxList. L'utilizzo del controllo CheckBoxList semplifica la creazione di un insieme di caselle di controllo mediante l'associazione dati. 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 sicurezza.

Per informazioni dettagliate sulle proprietà e sugli eventi del controllo server Web CheckBox, vedere la documentazione relativa alla classe CheckBox.

Esempio

Nell'esempio riportato di seguito viene presentata una dichiarazione di un controllo CheckBox in un file con estensione 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"/>

<asp:CheckBox id="Check1" runat="server"
     Text="CheckBox 1"
     AutoPostBack="True"/>

Nell'esempio riportato di seguito viene illustrato come creare un gestore eventi per l'evento CheckedChanged per copiare il 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.

Nota sulla sicurezza:
L'esempio include una casella di testo che accetta l'input dell'utente e rappresenta quindi una potenziale minaccia alla sicurezza. Per impostazione predefinita, le pagine Web ASP.NET verificano che l'input dell'utente non includa script o elementi HTML. Per ulteriori informazioni, vedere Cenni preliminari sugli attacchi tramite script.

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

Condividi tramite

Sintassi dichiarativa per il controllo server Web CheckBox

Note

Esempio

Vedere anche

Riferimenti

Altre risorse

Risorse aggiuntive