MenuItem.Target 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置要在其中显示与菜单项关联的网页内容的目标窗口或框架。
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
属性值
要在其中显示链接网页内容的目标窗口或框架。 默认值为空字符串(“”),用于刷新具有焦点的窗口或框架。
示例
下面的示例演示如何使用该 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 范围内的字母开头(不区分大小写),但以下划线开头的某些特殊值除外,如下表所示。 请注意,设置此属性将 Target 覆盖此菜单项的 Menu 控件的属性。
| 目标值 | 说明 |
|---|---|
_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 中的 XHTML 标准并 ASP.NET。
创建可访问的网页时,强烈建议避免使用属性 Target 来定位另一个窗口。 有关详细信息,请参阅 Visual Studio 中的辅助功能和 ASP.NET。