Sintassi dichiarativa per il controllo server Web HyperLink
Aggiornamento: novembre 2007
Crea nella pagina un collegamento su cui è possibile fare clic per passare a un'altra pagina.
<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"
/>
Note
Utilizzare il controllo HyperLink per creare un collegamento che consente di passare a un'altra pagina o a un'altra posizione nella pagina. La proprietà href consente di 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 del contenuto, è possibile chiudere il tag con /> anziché utilizzare un tag di chiusura distinto.
Se le proprietà Text e ImageUrl sono entrambe impostate, la proprietà ImageUrl ha la precedenza. Se l'immagine non è disponibile, verrà visualizzato il testo della 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. |
.gif "Nota di avviso") 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 relativa a HyperLink.
Quando si utilizza il controllo server Web HyperLink per l'esplorazione delle pagine dell'applicazione, è possibile inserire il carattere jolly tilde ("~") per indicare la directory principale dell'applicazione senza la necessità di impostare come hardcoded un nome di directory nell'URL relativo all'applicazione. È possibile, ad esempio, utilizzare "~/Default.aspx" per tornare alla pagina Default.aspx da qualsiasi pagina in qualsiasi sottodirectory dell'applicazione.
Esempio
Nell'esempio riportato di seguito viene illustrato come utilizzare un controllo HyperLink per passare a un'altra pagina 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>