MenuItem.Target プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

MenuItem.Target プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

メニュー項目に関連付けられている Web ページの内容を表示する対象ウィンドウまたは枠を取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property Target As
 String

Visual Basic (使用法)

Dim instance As MenuItem
Dim value As String

value = instance.Target

instance.Target = value

public string Target { get;
 set; }

C++

public:
property String^ Target {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_Target ()

/** @property */
public void set_Target (String value)

JScript

public function get Target
 () : String

public function set Target
 (value : String)

プロパティ値
リンクされた Web ページの内容を表示する対象ウィンドウまたは枠。既定値は空の文字列 ("") です。フォーカスのあるウィンドウまたは枠が更新されます。

解説

メニュー項目がクリックされたときに、そのメニュー項目にリンクされている Web ページの内容を表示するウィンドウまたは枠を指定するには、Target プロパティを使用します。値は、次の表に示すアンダースコア (_) から始まる特殊な値を除き、大文字小文字を区別しない A から Z の範囲の文字で始まる必要があります。このプロパティを設定すると、このメニュー項目の Menu コントロールの Target プロパティがオーバーライドされることに注意してください。

ターゲット値	説明
_blank	フレームなしの新しいウィンドウに内容を表示します。
_parent	直前のフレームセットの親に内容を表示します。
_search	検索ペインに内容を表示します。
_self	フォーカスのあるフレームに内容を表示します。
_top	最大化されたフレームなしのウィンドウに内容を表示します。

メモ
ブラウザのドキュメントを参照して、_search 値がサポートされているかどうか確認してください。たとえば、Microsoft Internet Explorer 5.0 以降では _search ターゲット値がサポートされています。

メモ
Target プロパティは、target 属性としてレンダリングされます。anchor 要素の target 属性は、XHTML 1.1 の厳密な文書型定義では許可されません。HyperLink の表示出力を XHTML 1.1 に準拠させる必要がある場合は、Target プロパティを設定しないでください。詳細については、「ASP.NET と XHTML」を参照してください。ユーザー補助対応の Web ページを作成する場合は、別のウィンドウを対象とする Target プロパティの使用は避けることを強くお勧めします。詳細については、「ASP.NET のユーザー補助」を参照してください。

メモ

Target プロパティは、target 属性としてレンダリングされます。anchor 要素の target 属性は、XHTML 1.1 の厳密な文書型定義では許可されません。HyperLink の表示出力を XHTML 1.1 に準拠させる必要がある場合は、Target プロパティを設定しないでください。詳細については、「ASP.NET と XHTML」を参照してください。

ユーザー補助対応の Web ページを作成する場合は、別のウィンドウを対象とする Target プロパティの使用は避けることを強くお勧めします。詳細については、「ASP.NET のユーザー補助」を参照してください。

使用例

Target プロパティを使用して、メニュー項目がクリックされたときに、そのメニュー項目にリンクされている Web ページの内容を表示するウィンドウまたは枠を指定するコード例を次に示します。

Visual Basic

<%@ Page Language="VB" %>

<html>
  <body>
    <form 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="C#" %>

<html>
  <body>
    <form 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>