共用方式為

HyperLink Web 服器控制項宣告式語法

  • 發行項

更新：2007 年 11 月

在網頁上建立可以讓使用者按一下之後移至另一網頁的連結。

 <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" />

備註

使用 HyperLink 控制項可建立將您移至另一網頁或網頁上其他位置的連結。請使用 href 屬性指定要連結到的網頁或位置。這個連結可以顯示為文字或是影像。若要顯示文字，請設定 Text 屬性，或將文字置於 HyperLink 控制項的開頭與結尾標記之間。若要顯示影像，請設定 ImageUrl 屬性。

注意事項：

由於 <asp:HyperLink> 項目不需要包含內容，所以您可以使用 /> 結束標記，而不必使用個別的結尾標記。

如果同時設定 Text 和 ImageUrl 屬性，ImageUrl 屬性則有優先權。如果沒有影像，就會顯示 Text 屬性中的文字。在支援工具提示功能的瀏覽器上，當滑鼠指標停在 HyperLink控制項上的時候，就會顯示 Text 屬性的值。

您可以設定 Target 屬性指定要顯示連結網頁的框架或視窗。值必須以 a-z 範圍內的字母 (不區分大小寫) 為開頭，除了下列以底線為開頭的特殊值以外：

_blank

在沒有框架的新視窗中顯示連結的網頁

_parent

在立即框架組父代 (Parent) 中顯示連結的網頁

_self

在具有焦點的框架中顯示連結的網頁

_top

在沒有框架的全視窗中顯示連結的網頁。
警告：

尚未顯示於 HyperLink 控制項中的文字，便還未經過 HTML 編碼。這樣便可以在文字中的 HTML 標記內嵌入指令碼。如果控制項的值來自使用者輸入，請務必驗證值來協助防止安全性的弱點。

如需 HyperLink Web 伺服器控制項之屬性和事件的詳細資訊，請參閱 HyperLink 文件。

當使用 HyperLink Web 伺服器控制項在應用程式中的網頁之間巡覽時，您可以使用波狀符號 ("~") 萬用字元來表示應用程式的根目錄，而不需要以硬式編碼的方式將目錄名稱加入為應用程式的相對 URL。例如，在應用程式中任何子目錄中的任何網頁，都可以使用 "~/Default.aspx" 巡覽回應用程式的 Default.aspx 網頁。

範例

下列範例示範如何使用 HyperLink 控制項移至另一個 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>

請參閱

參考

HyperLink

其他資源

Web 伺服器控制項語法