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 フォーカスのあるフレームに内容を表示します。
_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 使用して、コントロールがクリックされたときにリンクされた Web ページを表示するフレームまたはウィンドウを HyperLink 指定します。 Web ページは、プロパティを NavigateUrl 設定して指定します。

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

注意

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

アクセス可能な Web ページを作成する場合は、プロパティを使用して別のウィンドウを Target ターゲットにしないことを強くお勧めします。 詳細については、「Visual Studioと ASP.NET のアクセシビリティ」および「コントロールとアクセシビリティ ASP.NET」を参照してください。

適用対象

こちらもご覧ください