HyperLink Web 服务器控件声明性语法


<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" ????NavigateUrl="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" />

<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"
????NavigateUrl="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 控件在页上创建一个可使您移动到其他页或位置的链接。使用 NavigateUrl 属性指定要链接到的页或位置。链接既可显示为文本也可显示为图像。若要显示文本，请设置 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 控件移动到另一个网页。

Visual Basic?	复制代码
<%@ Page Language="VB" AutoEventWireup="True" %> <html> <head> </head> <body> <h3>HyperLink Example</h3> Click on the HyperLink:<br> <asp:HyperLink id="hyperlink1" ImageUrl="images/pict.jpg" NavigateUrl="http://www.microsoft.com" Text="Microsoft Official Site" Target="_new" runat="server"/> </body> </html>

Visual Basic?

复制代码

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>

</head>
<body>

   <h3>HyperLink Example</h3>

   Click on the HyperLink:<br>  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       

</body>
</html>

C#?	复制代码
<%@ Page Language="C#" AutoEventWireup="True" %> <html> <head> </head> <body> <h3>HyperLink Example</h3> Click on the HyperLink:<br> <asp:HyperLink id="hyperlink1" ImageUrl="images/pict.jpg" NavigateUrl="http://www.microsoft.com" Text="Microsoft Official Site" Target="_new" runat="server"/> </body> </html>

C#?

复制代码

<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>

</head>
<body>

   <h3>HyperLink Example</h3>

   Click on the HyperLink:<br>  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       

</body>
</html>

JScript?	复制代码
<%@ Page Language="JScript" AutoEventWireup="True" %> <html> <head> </head> <body> <h3>HyperLink Example</h3> Click on the HyperLink:<br> <asp:HyperLink id="hyperlink1" ImageUrl="images/pict.jpg" NavigateUrl="http://www.microsoft.com" Text="Microsoft Official Site" Target="_new" runat="server"/> </body> </html>

JScript?

复制代码

<%@ Page Language="JScript" AutoEventWireup="True" %>
<html>
<head>

</head>
<body>

  <h3>HyperLink Example</h3>

   Click on the HyperLink:<br>  

   <asp:HyperLink id="hyperlink1" 
                  ImageUrl="images/pict.jpg"
                  NavigateUrl="http://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_new"
                  runat="server"/>       

</body>
</html>

参考

HyperLink

其他资源

Web 服务器控件语法

备注

示例

请参见

参考

其他资源