ASP:BUTTON |
ASP : Bouton |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:Button paramètres> </asp:Button> |
Paramètres
| Paramètre | Description | ||
|---|---|---|---|
| AccessKey=valeur | Ce paramètre de balise permet d'indiquer un touche de raccourci à associer avec cette balise. | ||
| 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. | ||
| CommandArgument=valeur | Ce paramètre permet d'indiquer les paramètres de commande. | ||
| CommandName=valeur | Ce paramètre permet d'indiquer le nom de la commande. | ||
| 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é. | ||
| OnClientClick=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement lorsqu'un client effectue un clic. | ||
| OnCommand=valeur | Ce paramètre permet d'indiquer le gestionnaire d'événement lors d'une commande. | ||
| 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. | ||
| PostBackUrl=valeur | Ce paramètre de balise permet d'indiquer l'URL où doit être soumis le résultat de l'action du bouton. | ||
| 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. | ||
| ToolTip=valeur | Ce paramètre de balise permet d'indiquer l'info-bulle. | ||
| UseSubmitBehavior=valeur | Ce paramètre de balise permet d'indiquer si la balise doit effectuer l'évaluation du comportement avant de soumettre. | ||
| 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 bouton d'action utilisateur.
Remarques
- La balise «ASP:BUTTON» doit être situé à l'intérieur d'une balise de formulaire FORM du HTML avec un paramètre «runat=server» d'ASP.NET.
- Le contrôle <asp:Button> permet d'ajouter un bouton interactif sur une page ASP.NET, déclenchant une action côté serveur. Il est couramment utilisé pour envoyer des formulaires, déclencher des calculs ou rediriger l'utilisateur après une validation.
- La propriété Text du bouton permet de définir le libellé visible par l'utilisateur. Elle peut être personnalisée dynamiquement selon le contexte, ce qui rend l'interface plus intuitive et réactive aux besoins fonctionnels.
- Le contrôle est lié à l'événement serveur Click, ce qui permet d'exécuter du code dans le code-behind lorsqu'on clique sur le bouton. Ce lien direct entre interface utilisateur et logique serveur est un des grands atouts d'ASP.NET Web Forms.
- Le bouton peut déclencher la validation de formulaires ASP.NET si la propriété CausesValidation est activée. Cela assure que toutes les règles de validation soient respectées avant l'exécution du traitement, garantissant l'intégrité des données.
- La propriété CommandName permet d'associer une action logique au bouton, notamment utile dans les contrôles comme GridView ou Repeater, où plusieurs boutons peuvent exister avec des fonctions différentes dans une même structure.
- La personnalisation du style se fait facilement à l'aide des propriétés CssClass, BackColor, Font, BorderStyle,... Cela permet d'adapter le bouton à l'esthétique générale du site sans écrire de HTML manuellement.
- La syntaxe <asp:Button /> est une balise serveur auto-fermante, ce qui signifie qu'elle ne contient pas de contenu entre balises. Toutes les informations sont passées via les attributs, à la différence de certains contrôles HTML classiques.
- L'ajout d'un bouton ne nécessite pas de scripts JavaScript pour fonctionner de base. Le contrôle génère automatiquement le code nécessaire pour déclencher un postback vers le serveur lors du clic, ce qui en facilite l'utilisation.
- Il est possible de rendre le bouton inactif en définissant la propriété Enabled à false. Cela est utile pour désactiver l'interaction pendant un traitement en cours ou pour afficher des boutons seulement sous certaines conditions.
- Le contrôle Button peut également être utilisé pour déclencher des actions désynchronisées lorsqu'il est combiné avec UpdatePanel et AJAX. Cela permet de créer des interfaces dynamiques sans rechargement complet de la page.
- La propriété UseSubmitBehavior permet de choisir si le bouton se comporte comme un bouton de type submit HTML standard ou non. Cela peut avoir un impact sur la façon dont les navigateurs réagissent lors du clic, notamment pour les validations natives.
- On peut aussi combiner ce contrôle avec des messages de confirmation JavaScript via l'attribut OnClientClick. Cela permet par exemple d'afficher une boîte de dialogue avant de soumettre un formulaire, pour éviter les clics accidentels.
- Un bouton peut être généré dynamiquement côté serveur en instanciant un objet Button dans le code-behind. Cela permet de construire des interfaces complexes en fonction de données ou de logique métier, tout en gardant le contrôle sur les événements associés.
- Les boutons ASP.NET fonctionnent bien avec le ViewState, permettant de conserver leur état et leurs propriétés entre les différents postbacks de la page. Cela simplifie la gestion des interactions utilisateurs au sein d'une interface Web Forms.
- Le contrôle Button peut être placé dans un formulaire Runat="server" pour fonctionner correctement. Sans cette configuration, le bouton ne pourra pas déclencher d'événement côté serveur, ce qui est essentiel dans une architecture Web Forms.
Exemple
Voici un exemple permettant d'afficher 3 boutons :
- <%@ 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:Button id="BoutonA" runat="server" Text="Bouton A"></asp:Button>
- <asp:Button id="BoutonB" runat="server" Text="Bouton B"></asp:Button>
- <asp:Button id="BoutonC" runat="server" Text="Bouton C"></asp:Button>
- </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