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 。 XHTML 1.1 文件類型定義中不允許元素屬性targetanchor。 如果渲染輸出HyperLink必須符合 XHTML 1.1,請不要設定該Target屬性。 欲了解更多資訊,請參閱 Visual Studio 與 ASP.NET 中的 XHTML 標準主題。
在建立無障礙網頁時,強烈建議避免使用該 Target 屬性來指向其他視窗。 欲了解更多資訊,請參閱 Visual Studio 中的無障礙,以及 ASP.NETASP.NET 控制項與無障礙。