HtmlAnchor.Target プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
HtmlAnchor コントロールがクリックされたときにリンクされる Web ページの内容を表示するブラウザー ウィンドウまたはフレームの名前を取得または設定します。
public:
property System::String ^ Target { System::String ^ get(); void set(System::String ^ value); };
public string Target { get; set; }
member this.Target : string with get, set
Public Property Target As String
プロパティ値
HtmlAnchorがクリックされたときにリンクされた Web ページの内容を表示するブラウザー ウィンドウまたはフレーム。 既定値は空の文字列 ("") です。
例
次のコード例では、 Target プロパティを使用して、 HtmlAnchor コントロールが新しいフレームなしのウィンドウでクリックされたときに移動するページを表示する方法を示します。
<%@ 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 runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<a href="http://www.microsoft.com"
title="Open Microsoft site in a new window"
target="_blank"
runat="server"> Enter site.</a>
</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 runat="server">
<title>ASP.NET Sample</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<a href="http://www.microsoft.com"
target="_blank"
title="Open Microsoft.com site in a new window"
runat="server"> Enter site.</a>
</form>
</body>
</html>
注釈
Target プロパティを使用して、HtmlAnchor コントロールがクリックされたときにリンクされている Web ページの内容を表示するターゲット ウィンドウまたはフレームを指定します。
注
Target プロパティは、target属性としてレンダリングされます。 XHTML 1.1 ドキュメント型定義では、a要素のtarget属性は使用できません。
HtmlAnchorのレンダリングされた出力が XHTML 1.1 に準拠している必要がある場合は、Target プロパティを設定しないでください。 詳細については、「 Visual Studio および ASP.NET の XHTML 標準」を参照してください。
アクセス可能な Web ページを作成するときは、 Target プロパティを使用して別のウィンドウを対象としないようにします。 詳細については、「 アクセシビリティの ASP.NET」を参照してください。
Target値は、アンダースコアで始まる次の特殊な値を除き、A ~ Z の範囲の文字で始まる必要があります (大文字と小文字は区別されません)。
| 目標値 | 説明 |
|---|---|
_blank |
フレームなしで新しいウィンドウにコンテンツをレンダリングします。 |
_parent |
即時フレームセット親のコンテンツをレンダリングします。 |
_search |
検索ウィンドウにコンテンツをレンダリングします。 |
_self |
フレーム内のコンテンツをフォーカス付きでレンダリングします。 |
_top |
フレームを含まないフル ウィンドウでコンテンツをレンダリングします。 |
注
_search値がサポートされているかどうかを確認するには、ブラウザーのドキュメントを確認してください。 たとえば、Microsoft Internet Explorer 5.0 以降では、 _search ターゲット値がサポートされています。