Partager via

Syntaxe déclarative du contrôle serveur Web HyperLink

  • Article

Mise à jour : novembre 2007

Crée un lien sur la page et sur lequel les utilisateurs peuvent cliquer pour accéder à une autre page.

<asp:HyperLink
    AccessKey="string"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CssClass="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    ImageUrl="uri"
    href="uri"
    OnDataBinding="DataBinding event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Target="string|_blank|_parent|_search|_self|_top"
    Text="string"
    ToolTip="string"
    Visible="True|False"
    Width="size"
/>

Notes

Utilisez le contrôle HyperLink pour créer un lien vous permettant d'atteindre une autre page ou un autre emplacement de la page. Spécifiez la page ou l'emplacement vers lequel créer le lien en utilisant la propriété href. Le lien peut être affiché sous forme de texte ou sous forme d'image. Pour afficher du texte, définissez la propriété Text ou placez le texte entre les balises d'ouverture et de fermeture du contrôle HyperLink. Pour afficher une image, définissez la propriété ImageUrl.

Remarque :

Dans la mesure où l'élément <asp:HyperLink> n'a pas besoin d'avoir un contenu, vous pouvez fermer la balise avec /> au lieu d'utiliser une balise de fermeture distincte.

Si les deux propriétés Text et ImageUrl sont définies, la propriété ImageUrl est prioritaire. Si l'image n'est pas disponible, le texte figurant dans la propriété Text est affiché. Dans les navigateurs qui prennent en charge la fonctionnalité Info-bulles, la valeur de la propriété Text s'affiche quand le pointeur de la souris se trouve sur le contrôle HyperLink.

Vous pouvez spécifier la fenêtre ou le frame dans lequel la page liée sera affichée en définissant la propriété Target. Les valeurs doivent commencer par une lettre comprise entre a et z (sans respect de la casse), à l'exception des valeurs particulières suivantes qui commencent par un trait de soulignement :

_blank

Affiche la page liée dans une nouvelle fenêtre sans frame.

_parent

Affiche la page liée dans le parent du jeu de frames le plus proche.

_self

Affiche la page liée dans le frame ayant le focus.

_top

Affiche la page liée dans une fenêtre complète, sans frame.
Attention :

Le texte n'est pas codé au format HTML avant d'être affiché dans le contrôle HyperLink. Il est ainsi possible d'incorporer du script dans les balises HTML dans le texte. Si les valeurs du contrôle proviennent des entrées d'utilisateur, veillez à valider les valeurs pour permettre d'empêcher les failles en matière de sécurité.

Pour plus d'informations sur les propriétés et événements du contrôle serveur Web HyperLink, consultez la documentation de HyperLink.

Lorsque vous utilisez le contrôle serveur Web HyperLink pour accéder aux différentes pages de votre application, vous pouvez utiliser le caractère générique " ~ " (tilde) pour indiquer la racine de votre application sans devoir coder un nom de répertoire de façon irréversible dans l'URL relative de l'application. Par exemple, vous pouvez utiliser " ~/Default.aspx " pour revenir à la page Default.aspx de votre application à partir d'une page quelconque d'un sous-répertoire de l'application.

Exemple

L'exemple suivant montre comment utiliser un contrôle HyperLink pour accéder à une autre page Web.

<%@ Page Language="VB" AutoEventWireup="True" %>
<!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" >
<head>
    <title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">


   <h3>HyperLink Example</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       
</form>
</body>
</html>


<%@ Page Language="C#" AutoEventWireup="True" %>
<!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" >
<head>
    <title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">

   <h3>HyperLink Example</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       
</form>
</body>
</html>


<%@ Page Language="JScript" AutoEventWireup="True" %>
<!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" >
<head>
    <title>HyperLink Example</title>
</head>
<body>
<form id="Form1" runat="server">

  <h3>HyperLink Example</h3>

   Click on the HyperLink:<br />  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       
</form>
</body>
</html>

Voir aussi

Référence

HyperLink

Autres ressources

Syntaxe des contrôles serveur Web