通过

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

在直接框架集父级中显示链接页。

_self

在具有焦点的框架中显示链接页。

_top

在没有框架的完全窗口中显示链接页。
警告：

文本在 HyperLink 控件中显示之前并非 HTML 编码形式。这使得可以在文本中的 HTML 标记中嵌入脚本。如果控件的值是由用户输入的，请务必要对输入值进行验证以防止出现安全漏洞。

有关 HyperLink Web 服务器控件的属性和事件的详细信息，请参见 HyperLink 文档。

使用 HyperLink Web 服务器控件在应用程序的页面之间导航时，您可以使用颚化符（“~”）通配符来表示应用程序的根目录，而不需要将目录名硬编码为应用程序相对 URL。例如，您可以使用“~/Default.aspx”，从应用程序的任何子目录中的任何页导航回应用程序的 Default.aspx 页。

示例

下面的示例演示如何使用 HyperLink 控件移动到另一个网页。

<%@ 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 服务器控件语法