ASP:CHECKBOX |
ASP : Case à cocher |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:CheckBox paramètres> </asp:CheckBox> |
Paramètres
| Paramètre | Description | ||
|---|---|---|---|
| AccessKey=valeur | Ce paramètre de balise permet d'indiquer un touche de raccourci à associer avec cette balise. | ||
| AutoPostBack=valeur | Ce paramètre permet d'indiquer s'il faut poster immédiatement après avoir coché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'il ne faut pas poster. | ||
| "True" | Cette constante permet d'indiquer qu'il faut poster. | ||
| BackColor=valeur | Ce paramètre permet d'indiquer la couleur d'arrière plan de la balise. | ||
| BorderColor=valeur | Ce paramètre permet d'indiquer la couleur de bordure de la balise. | ||
| BorderStyle=valeur | Ce paramètre permet d'indiquer le style de bordure de la balise : NotSet, None, Dotted, Dashed, Solid, Double, Groove, Ridge, Inset ou Outset. | ||
| BorderWidth=valeur | Ce paramètre permet d'indiquer la largeur de la bordure de la balise. | ||
| CausesValidation=valeur | Ce paramètre permet d'indiquer s'il faut effectuer la validation ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer qu'il ne faut pas valider. | ||
| "True" | Cette constante permet d'indiquer qu'il faut valider. | ||
| Checked=valeur | Ce paramètre permet d'indiquer si la case est coché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la case n'est pas coché. | ||
| "True" | Cette constante permet d'indiquer que la case est coché. | ||
| CssClass=valeur | Ce paramètre permet d'indiquer la classe de feuille de style CSS de la balise. | ||
| Enabled=valeur | Ce paramètre permet d'indiquer si la balise doit être active ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la balise n'est pas active. | ||
| "True" | Cette constante permet d'indiquer que la balise n'est pas active. | ||
| EnableTheming=valeur | Ce paramètre permet d'indiquer si le thème de la balise doit être affiché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que le thème de la balise n'est pas affiché. | ||
| "True" | Cette constante permet d'indiquer que le thème de la balise est affiché. | ||
| EnableViewState=valeur | Ce paramètre permet d'indiquer si le ViewState de la balise doit être activé ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que le ViewState de la balise n'est pas actif. | ||
| "True" | Cette constante permet d'indiquer que le ViewState de la balise est actif. | ||
| Font-Bold=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être en gras ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas en gras. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est en gras. | ||
| Font-Italic=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être en italique ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas en italique. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est en italique. | ||
| Font-Names=valeur | Ce paramètre permet d'indiquer les noms de la police de caractères. | ||
| Font-Overline=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être surligné ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas surligné. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est surligné. | ||
| Font-Size=valeur | Ce paramètre permet d'indiquer la taille de la police de caractères de la balise : Smaller, Larger, XX-Small, X-Small, Small, Medium, Large, X-Large ou XX-Large. | ||
| Font-Strikeout=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être barré ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas barré. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est barré. | ||
| Font-Underline=valeur | Ce paramètre permet d'indiquer si la police de caractères de la balise doit être souligné ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la police de caractères n'est pas souligné. | ||
| "True" | Cette constante permet d'indiquer que la police de caractères est souligné. | ||
| ForeColor=valeur | Ce paramètre permet d'indiquer la couleur de premier plan de la balise. | ||
| Height=valeur | Ce paramètre permet d'indiquer la hauteur de la balise. | ||
| ID=valeur | Ce paramètre permet d'indiquer l'identificateur de la balise. | ||
| OnClick=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement lorsqu'un clic est effectué. | ||
| OnCheckedChanged=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement lorsque l'état de la case à cocher a changé. | ||
| OnDataBinding=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de DataBinding. | ||
| OnDisposed=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de disposition. | ||
| OnInit=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement d'initialisation. | ||
| OnLoad=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de chargement. | ||
| OnPreRender=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de pré-rendu. | ||
| OnUnload=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement de déchargement. | ||
| runat=valeur | Ce paramètre permet d'indiquer où doit être exécuté la balise : | ||
| Constante | Description | ||
| "server" | Cette constante permet d'indiquer qu'il faut exécuter la balise du côté serveur. | ||
| SkinID=valeur | Ce paramètre permet d'indiquer l'identificateur de Skin. | ||
| Style=valeur | Ce paramètre de balise permet d'indiquer des paramètres de feuille de style associé avec cette balise. | ||
| TabIndex=valeur | Ce paramètre de balise permet d'indiquer l'ordre de sélection des champs et éléments dans un formulaire. | ||
| Text=valeur | Ce paramètre de balise permet d'indiquer le texte à côté de la case à cocher. | ||
| TextAlign=valeur | Ce paramètre de balise permet d'indiquer l'alignement du texte à côté de la case à cocher. | ||
| Constante | Description | ||
| "Left" | Cette constante permet d'indiquer que l'alignement s'effectue à gauche. | ||
| "Right" | Cette constante permet d'indiquer que l'alignement s'effectue à droite. | ||
| ToolTip=valeur | Ce paramètre de balise permet d'indiquer l'info-bulle. | ||
| ValidationGroup=valeur | Ce paramètre de balise permet d'indiquer le groupe de validation. | ||
| Visible=valeur | Ce paramètre permet d'indiquer si la balise doit être affiché ou non : | ||
| Constante | Description | ||
| "False" | Cette constante permet d'indiquer que la balise n'est pas affiché. | ||
| "True" | Cette constante permet d'indiquer que la balise est affiché. | ||
| Width=valeur | Ce paramètre de balise permet d'indiquer la largeur de la balise. | ||
Description
Cette balise permet de définir un contrôle de case à cocher.
Remarques
- Le contrôle <asp:CheckBox> permet d'afficher une case à cocher sur une page ASP.NET, souvent utilisée pour représenter une option binaire comme "Accepter les conditions" ou "Recevoir la newsletter". Il s'agit d'un élément de formulaire très courant.
- La propriété Text permet d'associer une étiquette lisible à la case à cocher. Cela rend le contrôle plus intuitif pour l'utilisateur en indiquant clairement à quoi correspond la sélection. Ce texte peut être placé à gauche ou à droite selon les besoins.
- La valeur booléenne de la case est gérée via la propriété Checked. Si elle est à true, la case est cochée, sinon elle est vide. Cette propriété peut être lue ou modifiée dynamiquement dans le code-behind pour refléter l'état ou initialiser le formulaire.
- La syntaxe <asp:CheckBox> inclut l'attribut runat="server" pour indiquer que le contrôle est géré côté serveur. Sans cette instruction, le contrôle ne pourra pas interagir avec le code ASP.NET ni participer au postback.
- Le contrôle CheckBox déclenche l'événement CheckedChanged lorsqu'un utilisateur modifie son état. Cet événement peut être utilisé pour déclencher d'autres actions conditionnelles dans la page, comme afficher ou masquer des éléments.
- Pour que l'événement CheckedChanged fonctionne automatiquement sans bouton de validation, il faut activer la propriété AutoPostBack à true. Cela permet de déclencher un postback dès que l'état de la case change.
- Le style du contrôle peut être entièrement personnalisé grâce aux propriétés CSS (CssClass, Font, ForeColor,...). On peut donc l'intégrer visuellement de manière fluide à l'interface utilisateur globale du site.
- Chaque case à cocher peut avoir un identifiant (ID) unique, ce qui permet de la manipuler facilement dans le code-behind ou de l'associer à une logique de traitement spécifique, comme l'enregistrement de préférences utilisateur.
- On peut utiliser le contrôle CheckBox individuellement ou dans un groupe, selon les besoins. Lorsqu'il est utilisé en groupe, il permet de représenter plusieurs options indépendantes (contrairement aux boutons radio s'excluant mutuellement).
- Il est possible de rendre la case inactive à l'aide de la propriété Enabled. Cela permet par exemple d'afficher une option non modifiable ou dépendante d'une autre sélection dans le formulaire.
- La propriété ToolTip permet d'ajouter une info-bulle qui s'affiche au survol de la souris. Cela peut être utile pour fournir des explications supplémentaires sur l'option sans encombrer l'interface.
- Le contrôle est compatible avec le ViewState, ce qui permet de conserver son état entre deux postbacks. Ainsi, la case reste cochée ou décochée selon l'action précédente de l'utilisateur, sans logique supplémentaire.
- Le contrôle peut être utilisé dans des boucles ou des listes dynamiques, comme dans un Repeater ou un GridView, pour permettre à l'utilisateur de sélectionner plusieurs lignes ou éléments à la fois.
- En contexte de validation, on peut vérifier si une case est cochée côté serveur pour conditionner l'exécution d'un traitement, comme s'assurer qu'un utilisateur a bien accepté des conditions générales avant de poursuivre.
- Une case à cocher peut aussi être utilisée en conjonction avec des scripts JavaScript côté client pour améliorer l'interaction sans postback, comme afficher dynamiquement des champs additionnels ou modifier des styles à la volée.
Exemple
Voici un exemple permettant d'afficher 3 cases à cocher :
- <%@ Page Language="vb" %>
- <!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">
- <body>
- <form id="MonFormulaire" runat="server">
- <asp:CheckBox id="CheckBox1" runat="server" Text="Case a cocher 1"></asp:CheckBox>
- <asp:CheckBox id="CheckBox2" runat="server" Text="Case a cocher 2"></asp:CheckBox>
- <asp:CheckBox id="CheckBox3" runat="server" Text="Case a cocher 3"></asp:CheckBox>
- </form>
- </body>
- </html>
on obtiendra le résultat semblable suivant :
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 31 août 2017