MenuItem.Target プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
メニュー項目に関連付けられた 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
プロパティ値
リンクされた Web ページコンテンツを表示するターゲット ウィンドウまたはフレーム。 既定値は空の文字列 ("") で、ウィンドウまたはフレームをフォーカスで更新します。
例
次の例では、 Target プロパティを使用して、メニュー項目がクリックされたときにメニュー項目にリンクされた Web コンテンツを表示するウィンドウまたはフレームを指定する方法を示します。
<%@ Page Language="C#" %>
<!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>MenuItem Target Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItem Target Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
runat="server">
<items>
<asp:menuitem navigateurl="Home.aspx"
target="_self"
text="Home">
<asp:menuitem navigateurl="Music.aspx"
target="_self"
text="Music">
<asp:menuitem navigateurl="Classical.aspx"
target="_blank"
text="Classical"/>
<asp:menuitem navigateurl="Rock.aspx"
target="_blank"
text="Rock"/>
<asp:menuitem navigateurl="Jazz.aspx"
target="_blank"
text="Jazz"/>
</asp:menuitem>
<asp:menuitem navigateurl="Movies.aspx"
target="_self"
text="Movies">
<asp:menuitem navigateurl="Action.aspx"
target="_blank"
text="Action"/>
<asp:menuitem navigateurl="Drama.aspx"
target="_blank"
text="Drama"/>
<asp:menuitem navigateurl="Musical.aspx"
target="_blank"
text="Musical"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!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>MenuItem Target Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>MenuItem Target Example</h3>
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
runat="server">
<items>
<asp:menuitem navigateurl="Home.aspx"
target="_self"
text="Home">
<asp:menuitem navigateurl="Music.aspx"
target="_self"
text="Music">
<asp:menuitem navigateurl="Classical.aspx"
target="_blank"
text="Classical"/>
<asp:menuitem navigateurl="Rock.aspx"
target="_blank"
text="Rock"/>
<asp:menuitem navigateurl="Jazz.aspx"
target="_blank"
text="Jazz"/>
</asp:menuitem>
<asp:menuitem navigateurl="Movies.aspx"
target="_self"
text="Movies">
<asp:menuitem navigateurl="Action.aspx"
target="_blank"
text="Action"/>
<asp:menuitem navigateurl="Drama.aspx"
target="_blank"
text="Drama"/>
<asp:menuitem navigateurl="Musical.aspx"
target="_blank"
text="Musical"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
</form>
</body>
</html>
注釈
Target プロパティを使用して、メニュー項目がクリックされたときにメニュー項目にリンクされた Web コンテンツを表示するウィンドウまたはフレームを指定します。 次の表に示すように、アンダースコアで始まる特定の特殊な値を除き、値は A から Z の範囲の文字で始まる必要があります (大文字と小文字は区別されません)。 このプロパティを設定すると、このメニュー項目のMenu コントロールのTarget プロパティがオーバーライドされることに注意してください。
| 目標値 | 説明 |
|---|---|
_blank |
フレームなしで新しいウィンドウにコンテンツをレンダリングします。 |
_parent |
即時フレームセット親のコンテンツをレンダリングします。 |
_search |
検索ウィンドウにコンテンツをレンダリングします。 |
_self |
フレーム内のコンテンツをフォーカス付きでレンダリングします。 |
_top |
フレームを含まないフル ウィンドウでコンテンツをレンダリングします。 |
注
_search値がサポートされているかどうかを確認するには、ブラウザーのドキュメントを確認してください。 たとえば、Microsoft Internet Explorer 5.0 以降では、 _search ターゲット値がサポートされています。
注
Target プロパティは、target属性としてレンダリングされます。 アンカー要素の target 属性は、XHTML 1.1 厳密なドキュメント型定義では使用できません。
HyperLinkのレンダリングされた出力が XHTML 1.1 に準拠している必要がある場合は、Target プロパティを設定しないでください。 詳細については、「 Visual Studio および ASP.NET の XHTML 標準」を参照してください。
アクセス可能な Web ページを作成するときは、 Target プロパティを使用して別のウィンドウを対象としないことを強くお勧めします。 詳細については、「 Visual Studio のアクセシビリティ」と「ASP.NET」を参照してください。