HyperLink.Target 屬性

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定在按一下 HyperLink 控制項時顯示所連結之 Web 網頁內容的目標視窗或框架。

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

屬性值

String

目標視窗或框架，載入當按一下 HyperLink 控制項時所連結的 Web 網頁。 除了下列以底線為開頭的特殊值以外，該值必須以 A 到 Z (不區分大小寫) 範圍內的字母為開頭：

_blank 在無框架的新視窗中呈現內容。
_parent 在即時父代框架組中呈現內容。
_search 在搜尋窗格中呈現內容。
_self 在擁有焦點 (Focus) 的框架中呈現內容。
_top 在無框架的完整視窗中呈現內容。

注意：請檢查瀏覽器檔，以判斷是否 _search 支援此值。 例如，Microsoft Internet Explorer 5.0 (含) 以後版本支援 _search 目標值。

預設值為空字串 ("")。

屬性
BindableAttribute TypeConverterAttribute

範例

下列範例示範如何設定 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 屬性。 targetXHTML 1.1 檔案類型定義中不允許元素上的 anchor 屬性。 如果 的轉譯輸出 HyperLink 必須符合 XHTML 1.1 規範，請勿設定 Target 屬性。 如需詳細資訊，請參閱Visual Studio和 ASP.NET 中的 XHTML 標準主題。

建立可存取的網頁時，強烈建議您避免使用 Target 屬性來鎖定另一個視窗。 如需詳細資訊，請參閱Visual Studio和 ASP.NET 和 ASP.NET 控制項和協助工具中的協助工具。

適用於

另請參閱