ASP:LINKBUTTON |
ASP : Lien de bouton |
|---|---|
| ASP.NET | |
Syntaxe
|
<asp:LinkButton paramètres> </asp:LinkButton> |
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. | ||
| 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 appelant un sous-programme.
Remarques
- Le contrôle <asp:LinkButton> combine le style visuel d'un lien hypertexte avec le comportement d'un bouton serveur. Il permet de déclencher des actions côté serveur tout en se présentant comme un simple lien HTML.
- Ce contrôle est souvent utilisé lorsque l'on souhaite que l'utilisateur clique sur du texte souligné comme un lien, mais que cela déclenche une logique de traitement côté serveur, comme une suppression ou une redirection.
- Contrairement à un bouton classique (<asp:Button>), le LinkButton est plus discret visuellement, car il reprend l'apparence d'un lien, ce qui convient mieux à certaines interfaces minimalistes.
- La propriété Text permet de définir le texte affiché dans le lien. Ce texte est personnalisable à tout moment dans le code-behind, selon le contexte de la page ou des données affichées.
- Comme tout contrôle serveur, le LinkButton doit inclure runat="server" pour pouvoir être manipulé côté serveur et déclencher des événements comme Click.
- Il est très utilisé dans des listes de données (Repeater, GridView, ListView) pour ajouter des actions telles que modifier, supprimer, ou afficher un détail lié à un élément spécifique.
- La propriété CommandName peut être utilisée pour identifier l'action à réaliser lorsque le lien est cliqué, ce qui est particulièrement pratique dans les contrôles liés aux données.
- Associé à CommandArgument, le LinkButton peut transmettre une valeur personnalisée (comme un identifiant ou un index) à l'événement déclenché, ce qui permet de cibler précisément l'élément concerné.
- Le LinkButton permet également de créer des interfaces AJAX-friendly. Placé dans un UpdatePanel, il permet de déclencher un postback partiel sans recharger l'ensemble de la page.
- La propriété CausesValidation peut être utilisée pour indiquer si le bouton doit déclencher la validation des contrôles dans un formulaire avant d'exécuter sa logique.
- Il est possible de styliser le LinkButton avec des classes CSS pour modifier la couleur du texte, le soulignement, ou encore ajouter des icônes ou animations au survol.
- Même si le contrôle ressemble à un lien HTML classique (<a>), il génère en réalité un script JavaScript qui déclenche un postback. Cela signifie que le lien n'est pas accessible sans JavaScript activé.
- Le LinkButton est souvent préféré au Button dans des interfaces compactes, comme les colonnes d'actions d'un tableau, où l'espace est limité et un bouton classique serait trop encombrant.
- Il peut également être utilisé pour déclencher une navigation conditionnelle : par exemple, afficher un panneau ou une section supplémentaire sur la page en fonction du clic.
- Son comportement peut être enrichi avec des gestionnaires JavaScript (OnClientClick) pour intercepter l'action avant qu'elle n'atteigne le serveur, par exemple pour demander une confirmation à l'utilisateur.
Exemple
Voici un exemple permettant d'afficher 2 liens de bouton :
- <%@ 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:LinkButton id="LinkButton1" runat="server">Sauvegarder</asp:LinkButton>
- <asp:LinkButton id="LinkButton2" runat="server">Annuler</asp:LinkButton>
- </form>
- </body>
- </html>
on obtiendra le résultat semblable suivant :
| Sauvegarder Annuler |
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 31 août 2017