MenuItemBinding.Target プロパティ

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

MenuItemBinding オブジェクトが適用されるメニュー項目に関連付けられた 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

プロパティ値

String

リンクされた Web ページコンテンツを表示するターゲットウィンドウまたはフレーム。既定値は空の文字列 ("") で、ウィンドウまたはフレームをフォーカスで更新します。

例

次のコード例では、 Target プロパティを使用して、メニュー項目がクリックされたときに、メニュー項目に関連付けられている Web コンテンツを表示するウィンドウを指定する方法を示します。この例を正しく機能させるには、以下のサンプル XML データを Menu.xmlという名前のファイルにコピーする必要があります。


<%@ 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>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <DataBindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            formatstring="({0})" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            formatstring="[{0}]" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            formatstring="<{0}>" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </DataBindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

    </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>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <DataBindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            formatstring="({0})" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_self" />
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            formatstring="[{0}]" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            formatstring="<{0}>" 
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"
            target="_blank"/>
          
        </DataBindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

    </form>
  </body>
</html>

次のコードは、前の例のサンプルサイトマップデータです。

<MapHomeNode ImageUrl="~\Images\Home.gif"

Title="Home"

Description="Root Page"

ToolTip="Home Page">

<MapNode ImageUrl="~\Images\Music.gif"

Title="Music"

Description="Music Category"

ToolTip="Music Page">

<MapNode ImageUrl="~\Images\Classical.gif"

Title="Classical"

Description="Classical Section"

ToolTip="Classical Page"/>

<MapNode ImageUrl="~\Images\Rock.gif"

Title="Rock"

Description="Rock Section"

ToolTip="Rock Page"/>

<MapNode ImageUrl="~\Images\Jazz.gif"

Title="Jazz"

Description="Jazz Section"

ToolTip="Jazz Page"/>

</MapNode>

<MapNode ImageUrl="~\Images\Movies.gif"

Title="Movies"

Description="Movies Category"

ToolTip="Movies Page">

<MapNode ImageUrl="~\Images\Action.gif"

Title="Action"

Description="Action Section"

ToolTip="Action Page"/>

<MapNode ImageUrl="~\Images\Drama.gif"

Title="Drama"

Description="Drama Section"

ToolTip="Drama Page"/>

<MapNode ImageUrl="~\Images\Musical.gif"

Title="Musical"

Description="Musical Section"

ToolTip="Musical Page"/>

</MapNode>

</MapHomeNode>

注釈

Menu コントロールがデータソースにバインドされている場合は、Target プロパティを使用して、メニュー項目がクリックされたときにメニュー項目にリンクされた Web コンテンツを表示するウィンドウまたはフレームを指定します。

注

このプロパティを設定すると、MenuItemBinding オブジェクトが適用されるメニュー項目のMenu コントロールのMenu.Target プロパティがオーバーライドされます。各メニュー項目の MenuItem.Target プロパティを直接設定することで、このプロパティを選択的にオーバーライドできます。

次の表に示すように、アンダースコアで始まる特定の特殊な値を除き、ターゲット値は A から Z の範囲の文字で始まる必要があります (大文字と小文字は区別されません)。

目標値	説明
`_blank`	フレームなしで新しいウィンドウにコンテンツをレンダリングします。
`_parent`	即時フレームセット親のコンテンツをレンダリングします。
`_search`	検索ウィンドウにコンテンツをレンダリングします。
`_self`	フレーム内のコンテンツをフォーカス付きでレンダリングします。
`_top`	フレームを含まないフルウィンドウでコンテンツをレンダリングします。

注

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

注

Target プロパティは、target属性としてレンダリングされます。 XHTML 1.1 ドキュメント型定義では、anchor要素のtarget属性は使用できません。 MenuItemBinding オブジェクトのレンダリングされた出力が XHTML 1.1 に準拠している必要がある場合は、Target プロパティを設定しないでください。詳細については、 Visual Studio と ASP.NET の XHTML 標準に関するトピックを参照してください。

アクセス可能な Web ページを作成するときは、 Target プロパティを使用して別のウィンドウを対象としないことを強くお勧めします。詳細については、「アクセシビリティの ASP.NET」を参照してください。

適用対象

こちらもご覧ください

フィードバック

このページはお役に立ちましたか?