次の方法で共有


HyperLink.Target プロパティ

定義

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

プロパティ値

HyperLink コントロールがクリックされたときのリンク先 Web ページを読み込む、表示先のウィンドウまたはフレーム。 値は、次の表に記載されているアンダースコア (_) から始まる特殊な値を除き、大文字小文字を区別しない 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 使用して、コントロールがクリックされたときにリンクされた Web ページを表示するフレームまたはウィンドウを HyperLink 指定します。 Web ページは、 プロパティを NavigateUrl 設定して指定します。

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

注意

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

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

適用対象

こちらもご覧ください