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 使用して、コントロールがクリックされたときにリンクされた Web ページを表示するフレームまたはウィンドウを HyperLink 指定します。 Web ページは、 プロパティを NavigateUrl 設定して指定します。
このプロパティが設定されていない場合、コントロールがクリックされると HyperLink 、フォーカスのあるブラウザーまたはウィンドウが更新されます。
注意
プロパティは Target 属性として target
レンダリングされます。 要素の anchor
属性はtarget
、XHTML 1.1 ドキュメント型定義では使用できません。 のレンダリングされた出力HyperLinkが Target XHTML 1.1 に準拠している必要がある場合は、 プロパティを設定しないでください。 詳細については、「 Visual Studio および ASP.NET の XHTML 標準」を参照してください。
アクセシビリティの高い Web ページを作成する場合は、 プロパティを使用して別の Target ウィンドウをターゲットにしないようにすることを強くお勧めします。 詳細については、「 Visual Studio のアクセシビリティ」および「ASP.NET および ASP.NET コントロールとアクセシビリティ」を参照してください。
適用対象
こちらもご覧ください
.NET