語言

MenuItemBinding.Target 屬性

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

取得或設定目標視窗或框架，以顯示與該物件套用的選單 MenuItemBinding 項目相關的網頁內容。

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

顯示連結網頁內容的目標視窗或框架。 預設值為空字串（“”），用於聚焦刷新視窗或框架。

範例

以下程式碼範例示範如何使用該 Target 屬性指定在點擊選單項目時，顯示與該選單項目相關聯的網頁內容的視窗。 為了讓這個範例正確運作，你必須將下方的範例 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 屬性指定點擊選單項目時，要顯示連結到選單項目的網頁內容的視窗或框架。

Note

設定此屬性會Menu.Target覆蓋該物件所應用選單項目Menu控制項的MenuItemBinding屬性。 你可以選擇性地覆蓋這個屬性，直接設定 MenuItem.Target 每個選單項目的屬性。

目標值必須以 A 到 Z 範圍內的字母開頭（不區分大小寫），但某些特殊值以底線開頭，如下表所示。

目標值 Description
_blank 它會在一個沒有框架的新視窗中渲染內容。
_parent 將內容渲染到直接的框架集父節點。
_search 在搜尋窗格中呈現內容。
_self 能在畫面中聚焦渲染內容。
_top 能在完整視窗中渲染內容，且不包含框架。

Note

請查看瀏覽器文件，確認該 _search 數值是否被支援。 例如，Microsoft Internet Explorer 5.0 及以後版本支援目標 _search 值。

Note

該 Target 屬性以屬性形式呈現 target 。 XHTML 1.1 文件類型定義中不允許元素屬性targetanchor。 如果物件的渲染輸出Target必須符合 XHTML 1.1 標準，則不要設定該MenuItemBinding屬性。 欲了解更多資訊，請參閱 Visual Studio 與 ASP.NET 中的 XHTML 標準主題。

在建立無障礙網頁時，強烈建議避免使用該 Target 屬性來指向其他視窗。 更多資訊請參閱 ASP.NET 無障礙。

適用於

另請參閱