HyperLink.Target 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置单击 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 控件时加载链接到的网页的目标窗口或框架。 值必须以 a 到 z 的字母(不区分大小写)开头,但下表所列以下划线开头的特殊值除外。
_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
。 如果呈现的输出HyperLink必须符合 XHTML 1.1,则不要设置Target该属性。 有关详细信息,请参阅Visual Studio和 ASP.NET 中的 XHTML 标准主题。
创建可访问的网页时,强烈建议避免使用 Target 属性来定位另一个窗口。 有关详细信息,请参阅Visual Studio和 ASP.NET 中的辅助功能以及 ASP.NET 控件和辅助功能。