Comment : répondre à la sélection d'un utilisateur dans un contrôle serveur Web CheckBox

  • Article

Mise à jour : novembre 2007

Lorsque l'utilisateur sélectionne un contrôle CheckBox, celui-ci déclenche un événement auquel vous pouvez répondre.

Remarque :

Le contrôle CheckBoxList déclenche les événements différemment des contrôles CheckBox individuels. Pour plus d'informations, consultez Comment : déterminer la sélection dans un contrôle serveur Web List.

Il est possible que vous n'ayez pas du tout à répondre directement à l'événement de vérification d'un contrôle CheckBox. Vous répondez à l'événement uniquement s'il est important de connaître le moment où l'utilisateur a procédé à une modification de la sélection de la case à cocher. Si vous souhaitez seulement connaître l'état de la case à cocher lorsqu'elle est sélectionnée et non savoir si elle a été modifiée, il vous suffit de tester la case à cocher après la publication du formulaire sur le serveur. Pour plus d'informations, consultez Comment : obtenir et définir par programme une valeur du contrôle serveur Web CheckBox.

Pour répondre à une sélection dans un contrôle CheckBox

  • Créez un gestionnaire d'événements pour l'événement CheckedChanged du contrôle.

    Par défaut, l'événement CheckedChanged ne provoque pas la publication immédiate de la page sur le serveur. Au lieu de cela, l'événement est déclenché dans le code serveur la prochaine fois que le formulaire est publié. Pour que l'événement CheckedChanged provoque une publication immédiate, affectez à la propriété AutoPostBack du contrôle CheckBox la valeur true.

    Remarque :

    La capacité d'un contrôle CheckBox à effectuer des publications sur le serveur lorsqu'il est activé exige que le navigateur prenne en charge ECMAScript (JavaScript) et que ce script soit activé sur le navigateur de l'utilisateur.

    L'exemple suivant affiche « True » ou « False » dans un contrôle serveur Web Label pour prendre en compte la dernière modification apportée à un contrôle CheckBox.

    Protected Sub CheckBox1_CheckedChanged(ByVal sender As _
   System.Object, ByVal e As System.EventArgs) Handles _
   CheckBox1.CheckedChanged
   Label1.Text = "CheckBox1 selection is: " & _
       CheckBox1.Checked.ToString()
End Sub

    protected void CheckBox1_CheckedChanged(object sender, EventArgs e)
{
   Label1.Text = "CheckBox1 selection is: " + CheckBox1.Checked.ToString();
}

Voir aussi

Référence

Vue d'ensemble des contrôles serveur Web CheckBox et CheckBoxList