HyperLink.Target プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 プロパティを使用して、HyperLink コントロールがクリックされたときにリンクされた Web ページを表示するフレームまたはウィンドウを指定します。 Web ページは、 NavigateUrl プロパティを設定して指定します。
このプロパティが設定されていない場合、 HyperLink コントロールがクリックされると、フォーカスのあるブラウザーまたはウィンドウが更新されます。
注
Target プロパティは、target属性としてレンダリングされます。 XHTML 1.1 ドキュメント型定義では、anchor要素のtarget属性は使用できません。
HyperLinkのレンダリングされた出力が XHTML 1.1 に準拠している必要がある場合は、Target プロパティを設定しないでください。 詳細については、 Visual Studio と ASP.NET の XHTML 標準に関するトピックを参照してください。
アクセス可能な Web ページを作成するときは、 Target プロパティを使用して別のウィンドウを対象としないことを強くお勧めします。 詳細については、「 Visual Studio のアクセシビリティ」および「ASP.NET および ASP.NET コントロールとアクセシビリティ」を参照してください。