ASP:HYPERLINK |
ASP : Hyperlien |
|---|---|
| ASP.NET | |
Syntaxe
|
<ASP:HYPERLINK paramètres> texte </ASP:HYPERLINK> |
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. | ||
| 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. | ||
| ImageUrl=valeur | Ce paramètre permet d'indiquer un lien URL vers une image. | ||
| NavigateUrl=valeur | Ce paramètre permet d'indiquer un lien URL où effectuer la redirection du navigateur Web. | ||
| 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. | ||
| Target=frame | Ce paramètre de balise permet d'indiquer l'action à apporter au lien à ouvrir ou le nom de la fenêtre cible: | ||
| Valeur | Description | ||
| "_blank" | Cette valeur permet d'indiquer de charger une nouvelle fenêtre | ||
| "_parent" | Cette valeur permet d'indiquer un chargement dans une pleine page si le «FRAME» n'a pas de parent | ||
| "_search" | Cette valeur permet d'indiquer une recherche | ||
| "_self" | Cette valeur permet d'indiquer de charger la même page | ||
| "_top" | Cette valeur permet d'indiquer le chargement de la page en haut du «FRAME». | ||
| nom | Ces valeurs permettent d'indiquer le nom d'une nouvelle fenêtre (POP-UP) | ||
| Text=valeur | Ce paramètre de balise permet d'indiquer le texte associé à l'hyperlien. | ||
| 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 lien URL.
Remarques
- Le contrôle <asp:HyperLink> permet d'afficher un lien cliquable sur une page Web, exactement comme la balise <a> du HTML, mais avec des fonctionnalités supplémentaires propres à ASP.NET côté serveur.
- Grâce à l'attribut runat="server", ce lien peut être configuré dynamiquement dans le code-behind. Il est alors possible de définir ou de modifier l'URL cible (NavigateUrl) selon la logique de l'application.
- Le contenu entre les balises du HyperLink constitue le texte visible par l'utilisateur. Ce texte peut aussi être défini via la propriété Text dans le code serveur pour plus de flexibilité.
- Le lien peut pointer vers une page interne du site, un fichier ou une URL externe. Il suffit d'assigner la bonne valeur à la propriété NavigateUrl, comme par exemple "https://www.example.com".
- Il est possible d'ouvrir le lien dans une nouvelle fenêtre ou un nouvel onglet en définissant la propriété Target="_blank", tout comme dans une balise HTML classique. Cette propriété est également accessible côté serveur.
- Contrairement au contrôle LinkButton, HyperLink ne déclenche aucun postback. Il agit comme un lien statique ou dynamique qui redirige l'utilisateur vers une autre ressource sans interagir avec le serveur ASP.NET.
- On peut personnaliser l'apparence du lien à l'aide de styles CSS ou en utilisant des propriétés comme CssClass, Font, ForeColor, etc. Cela permet de l'adapter au design général de l'application.
- Le contrôle HyperLink peut être utilisé dans des composants complexes comme un GridView pour insérer dynamiquement des liens vers des pages de détails, d'édition ou de téléchargement pour chaque ligne.
- Il est possible d'ajouter une icône ou une image à la place du texte en utilisant la propriété ImageUrl, ce qui permet de transformer le lien en bouton graphique ou en pictogramme interactif.
- En combinant les propriétés NavigateUrl et DataBinding, on peut générer dynamiquement des liens personnalisés en fonction des données récupérées depuis une base de données ou un service web.
- Le contrôle peut être désactivé logiquement dans certaines situations en ne lui assignant pas de NavigateUrl ou en rendant son Visible à false côté serveur, ce qui permet de gérer les permissions d'accès.
- Comme tout contrôle ASP.NET, HyperLink possède une propriété ID qui permet de l'identifier et de le manipuler dans le code serveur. Cela est utile lorsqu'on veut changer son comportement selon le rôle utilisateur ou l'état de la page.
- Dans les formulaires complexes, le HyperLink est pratique pour insérer des raccourcis vers des sections spécifiques du site, comme une page d'aide, une FAQ ou des conditions d'utilisation.
- On peut également utiliser le contrôle HyperLink pour générer des liens contenant des paramètres dynamiques dans l'URL, comme ?id=123, ce qui est utile pour la navigation entre les entités d'un système.
- Le contrôle est aussi compatible avec les expressions de liaison (<%# %>) pour générer des valeurs dynamiques au moment du data-binding, ce qui renforce sa flexibilité dans les interfaces riches.
Exemple
Voici un exemple permettant d'afficher 3 liens :
- <%@ 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:HyperLink id="HyperLink1" runat="server" NavigateUrl="http://www.gladir.com/CODER/">Lien 1</asp:HyperLink><br />
- <asp:HyperLink id="HyperLink2" runat="server" NavigateUrl="http://www.gladir.com/OS/">Lien 2</asp:HyperLink><br />
- <asp:HyperLink id="HyperLink3" runat="server" NavigateUrl="http://www.gladir.com/SERVER/">Lien 3</asp:HyperLink><br />
- </form>
- </body>
- </html>
on obtiendra le résultat semblable suivant :
|
Lien 1 Lien 2 Lien 3 |
Voir également
Articles - Les géants de l'informatique - Microsoft
Dernière mise à jour : Samedi, le 31 août 2017