HyperLink.Target プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

HyperLink.Target プロパティ

HyperLink コントロールがクリックされたときに、リンク先 Web ページの内容を表示するウィンドウまたはフレームを取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property Target As
 String

Visual Basic (使用法)

Dim instance As HyperLink
Dim value As String

value = instance.Target

instance.Target = value

public string Target { get;
 set; }

C++

public:
property String^ Target {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_Target ()

/** @property */
public void set_Target (String value)

JScript

public function get Target
 () : String

public function set Target
 (value : String)

プロパティ値
HyperLink コントロールがクリックされたときのリンク先 Web ページを読み込む、表示先のウィンドウまたはフレーム。値は、次の表に記載されているアンダースコア (_) から始まる特殊な値を除き、大文字小文字を区別しない a から z の範囲の文字で始まる必要があります。

_blank	フレームなしの新しいウィンドウに内容を表示します。
_parent	直前のフレームセットの親に内容を表示します。
_search	検索ペインに内容を表示します。
_self	フォーカスのあるフレームに内容を表示します。
_top	最大化されたフレームなしのウィンドウに内容を表示します。

メモ
ブラウザのドキュメントを参照して、_search 値がサポートされているかどうか確認してください。たとえば、Microsoft Internet Explorer 5.0 以降では _search ターゲット値がサポートされています。

既定値は空の文字列 ("") です。

解説

Target プロパティを使用して、HyperLink コントロールがクリックされたときのリンク先 Web ページを表示する、表示先のウィンドウまたはフレームを指定します。NavigateUrl プロパティを設定することにより、Web ページが指定されます。

このプロパティが設定されていない場合は、HyperLink コントロールがクリックされたときに、フォーカスがあるブラウザまたはウィンドウが更新されます。

メモ
Target プロパティは、target 属性としてレンダリングされます。anchor 要素の target 属性は、XHTML 1.1 の文書型定義では使用できません。HyperLink の表示出力を XHTML 1.1 に準拠させる必要がある場合は、Target プロパティを設定しないでください。詳細については、「ASP.NET と XHTML」のトピックを参照してください。ユーザー補助対応の Web ページを作成する場合は、別のウィンドウを対象とする Target プロパティの使用は避けることを強くお勧めします。詳細については、「ASP.NET のユーザー補助」を参照してください。

メモ

Target プロパティは、target 属性としてレンダリングされます。anchor 要素の target 属性は、XHTML 1.1 の文書型定義では使用できません。HyperLink の表示出力を XHTML 1.1 に準拠させる必要がある場合は、Target プロパティを設定しないでください。詳細については、「ASP.NET と XHTML」のトピックを参照してください。

ユーザー補助対応の Web ページを作成する場合は、別のウィンドウを対象とする Target プロパティの使用は避けることを強くお勧めします。詳細については、「ASP.NET のユーザー補助」を参照してください。

使用例

Target プロパティを設定して、HyperLink コントロールに関連付けられているページを表示するウィンドウまたはフレームを指定する方法を次の例に示します。

Visual Basic

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

</head>
<body>

   <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"/>       

</body>
</html>

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

</head>
<body>

   <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"/>       

</body>
</html>

JScript

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

</head>
<body>

   <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"/>       

</body>
</html>