语言

HyperLink.Target 属性

定义

获取或设置在单击控件时 HyperLink 显示链接到的网页内容的目标窗口或框架。

public:
 property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public string Target { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))]
public string Target { get; set; }
[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.TargetConverter))>]
member this.Target : string with get, set
Public Property Target As String

属性值

在单击控件时 HyperLink 加载链接到的网页的目标窗口或框架。 值必须以字母开头(不区分大小写),但下表中列出的特殊值除外,以下划线开头。

_blank 在不带框架的新窗口中呈现内容。
_parent 呈现即时帧集父级中的内容。
_search 在搜索窗格中呈现内容。
_self 呈现具有焦点的帧中的内容。
_top 在全窗口中呈现内容,而不显示框架。

注意:检查浏览器文档以确定 _search 是否支持该值。 例如,Microsoft Internet Explorer 5.0 及更高版本支持 _search 目标值。

默认值为空字符串 ("")。

属性

示例

下面的示例演示如何设置属性 Target 以指定窗口或框架以显示与 HyperLink 控件关联的页面。

<%@ 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 Sample</title>
</head>
<body>
<form id="Form1" runat="server">


   <h3>HyperLink Sample</h3>

   Click on the HyperLink:<br />  

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

</form>
</body>
</html>
<%@ 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 Sample</title>
</head>
<body>
<form id="Form1" runat="server">

   <h3>HyperLink Sample</h3>

   Click on the HyperLink:<br />  

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

</form>
</body>
</html>

注解

使用该 Target 属性指定显示单击控件时链接到的网页的 HyperLink 框架或窗口。 通过设置 NavigateUrl 属性来指定网页。

如果未设置此属性,则单击控件时,具有焦点的 HyperLink 浏览器或窗口将刷新。

注释

该 Target 属性呈现为 target 属性。 target XHTML 1.1 文档类型定义中不允许元素上的anchor属性。 如果呈现的 XHTML 1.1 输出符合 XHTML 1.1,Target则不要设置HyperLink该属性。 有关详细信息,请参阅 Visual Studio 中的 XHTML 标准主题和 ASP.NET。

创建可访问的网页时,强烈建议避免使用属性 Target 来定位另一个窗口。 有关详细信息,请参阅 Visual Studio 中的辅助功能,ASP.NET 和 ASP.NET 控件和辅助功能。

适用于

另请参阅