Controllo server Web HyperLink
Crea nella pagina un collegamento su cui è possibile fare clic per passare a un'altra pagina.
<asp:HyperLinkid="HyperLink1" NavigateURL="url" Text="HyperLinkText" ImageUrl="url" Target="window" runat="server"/>
or
<asp:HyperLinkid="HyperLink1""" NavigateURL="url" ImageUrl="url" Target="window" runat="server"> Text</asp:HyperLink>
Osservazioni
Utilizzare il controllo HyperLink per creare un collegamento che consente di passare a un'altra pagina o a un'altra posizione nella pagina. Utilizzando la proprietà NavigateURL, specificare la pagina o il percorso a cui collegarsi. Il collegamento può essere visualizzato sotto forma di testo o di immagine. Per visualizzarlo come testo, impostare la proprietà Text oppure inserire il testo tra i tag di apertura e di chiusura del controllo HyperLink. Per visualizzarlo come immagine, impostare la proprietà ImageUrl.
Nota Poiché non è necessario che l'elemento <asp:HyperLink> includa un contenuto, è possibile chiudere il tag con /> anziché utilizzare un tag di chiusura distinto.
Se si impostano entrambe le proprietà Text e ImageUrl, la proprietà ImageUrl avrà la priorità. Se l'immagine non è disponibile, verrà visualizzato il testo impostato nella proprietà Text. Nei browser che supportano la funzione di descrizione dei comandi, quando il puntatore del mouse viene posizionato sopra il controllo HyperLink viene visualizzato il valore della proprietà Text.
Se si imposta la proprietà Target, è possibile specificare il frame o la finestra in cui visualizzare la pagina collegata. È necessario che i valori inizino con una lettera compresa tra la A e la Z (senza distinzione tra maiuscole e minuscole), fatta eccezione per i seguenti valori speciali, che iniziano con un carattere di sottolineatura:
| _blank | Visualizza la pagina collegata in una nuova finestra senza frame. |
| _parent | Visualizza la pagina collegata nella pagina con frame padre immediata. |
| _self | Visualizza la pagina collegata nel frame con lo stato attivo. |
| _top | Visualizza la pagina collegata in una finestra a tutto schermo senza frame. |
Attenzione Il testo non viene codificato in formato HTML prima di essere visualizzato nel controllo HyperLink. È pertanto possibile incorporare script all'interno dei tag HTML presenti nel testo. Se i valori del controllo provengono dall'input dell'utente, assicurarsi di convalidare tali valori per evitare problemi di protezione.
Per informazioni dettagliate sulle proprietà e sugli eventi del controllo server Web HyperLink vedere la documentazione di HyperLink.
Esempio
Nell'esempio seguente viene mostrato come utilizzare il controllo HyperLink per passare a un'altra pagina Web.
<html>
<head>
</head>
<body>
<h3>HyperLink Sample</h3>
Click on the HyperLink:<br>
<asp:HyperLink id="hyperLink1"
ImageUrl="images\pict.jpg"
NavigateURL="https://www.microsoft.com"
Text="Microsoft Official Site"
Target="_new"
runat="server"/>
</body>
</html>