次の方法で共有

HyperLink.Target プロパティ

  • [アーティクル]

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

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

構文

'宣言
<TypeConverterAttribute(GetType(TargetConverter))> _
Public Property Target As String
'使用
Dim instance As HyperLink
Dim value As String

value = instance.Target

instance.Target = value

[TypeConverterAttribute(typeof(TargetConverter))] 
public string Target { get; set; }

[TypeConverterAttribute(typeof(TargetConverter))] 
public:
property String^ Target {
    String^ get ();
    void set (String^ value);
}

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

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

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 ページを表示する、表示先のウィンドウまたはフレームを指定します。href プロパティを設定することにより、Web ページが指定されます。

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

メモメモ :

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

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

使用例

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

<%@ 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"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  runat="server"/>       

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

<%@ 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"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  runat="server"/>       

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

<%@ Page Language="JScript" 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"
                  href="https://www.microsoft.com"
                  Text="Microsoft Official Site"
                  Target="_blank"
                  runat="server"/>       

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

プラットフォーム

Windows 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

バージョン情報

.NET Framework

サポート対象 : 3.0,2.0,1.1,1.0

参照

関連項目

HyperLink クラス
HyperLink メンバ
System.Web.UI.WebControls 名前空間
HyperLink.href プロパティ

その他の技術情報

HyperLink Web サーバー コントロール