Menu 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在 ASP.NET 网页中显示菜单。
public ref class Menu : System::Web::UI::WebControls::HierarchicalDataBoundControl, System::Web::UI::INamingContainer, System::Web::UI::IPostBackEventHandler
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class Menu : System.Web.UI.WebControls.HierarchicalDataBoundControl, System.Web.UI.INamingContainer, System.Web.UI.IPostBackEventHandler
[<System.Web.UI.ControlValueProperty("SelectedValue")>]
type Menu = class
inherit HierarchicalDataBoundControl
interface IPostBackEventHandler
interface INamingContainer
Public Class Menu
Inherits HierarchicalDataBoundControl
Implements INamingContainer, IPostBackEventHandler
- 继承
- 属性
- 实现
示例
下面的代码示例演示如何使用声明性语法创建 Menu 包含静态菜单项的控件。
<%@ 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" >
<!-- For the hover styles of the Menu control to -->
<!-- work correctly, you must include this head -->
<!-- element. -->
<head runat="server">
<title>Menu Declarative Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu Declarative Example</h3>
<!-- Use declarative syntax to create the -->
<!-- menu structure. Submenu items are -->
<!-- created by nesting them in parent menu -->
<!-- items. -->
<asp:menu id="NavigationMenu"
disappearafter="2000"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
font-names="Arial"
target="_blank"
runat="server">
<staticmenuitemstyle backcolor="LightSteelBlue"
forecolor="Black"/>
<statichoverstyle backcolor="LightSkyBlue"/>
<dynamicmenuitemstyle backcolor="Black"
forecolor="Silver"/>
<dynamichoverstyle backcolor="LightSkyBlue"
forecolor="Black"/>
<items>
<asp:menuitem navigateurl="Home.aspx"
text="Home"
tooltip="Home">
<asp:menuitem navigateurl="Music.aspx"
text="Music"
tooltip="Music">
<asp:menuitem navigateurl="Classical.aspx"
text="Classical"
tooltip="Classical"/>
<asp:menuitem navigateurl="Rock.aspx"
text="Rock"
tooltip="Rock"/>
<asp:menuitem navigateurl="Jazz.aspx"
text="Jazz"
tooltip="Jazz"/>
</asp:menuitem>
<asp:menuitem navigateurl="Movies.aspx"
text="Movies"
tooltip="Movies">
<asp:menuitem navigateurl="Action.aspx"
text="Action"
tooltip="Action"/>
<asp:menuitem navigateurl="Drama.aspx"
text="Drama"
tooltip="Drama"/>
<asp:menuitem navigateurl="Musical.aspx"
text="Musical"
tooltip="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" >
<!-- For the hover styles of the Menu control to -->
<!-- work correctly, you must include this head -->
<!-- element. -->
<head runat="server">
<title>Menu Declarative Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu Declarative Example</h3>
<!-- Use declarative syntax to create the -->
<!-- menu structure. Submenu items are -->
<!-- created by nesting them in parent menu -->
<!-- items. -->
<asp:menu id="NavigationMenu"
disappearafter="2000"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
font-names="Arial"
target="_blank"
runat="server">
<staticmenuitemstyle backcolor="LightSteelBlue"
forecolor="Black"/>
<statichoverstyle backcolor="LightSkyBlue"/>
<dynamicmenuitemstyle backcolor="Black"
forecolor="Silver"/>
<dynamichoverstyle backcolor="LightSkyBlue"
forecolor="Black"/>
<items>
<asp:menuitem navigateurl="Home.aspx"
text="Home"
tooltip="Home">
<asp:menuitem navigateurl="Music.aspx"
text="Music"
tooltip="Music">
<asp:menuitem navigateurl="Classical.aspx"
text="Classical"
tooltip="Classical"/>
<asp:menuitem navigateurl="Rock.aspx"
text="Rock"
tooltip="Rock"/>
<asp:menuitem navigateurl="Jazz.aspx"
text="Jazz"
tooltip="Jazz"/>
</asp:menuitem>
<asp:menuitem navigateurl="Movies.aspx"
text="Movies"
tooltip="Movies">
<asp:menuitem navigateurl="Action.aspx"
text="Action"
tooltip="Action"/>
<asp:menuitem navigateurl="Drama.aspx"
text="Drama"
tooltip="Drama"/>
<asp:menuitem navigateurl="Musical.aspx"
text="Musical"
tooltip="Musical"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
</form>
</body>
</html>
下面的代码示例演示如何将 Menu 控件绑定到控件 SiteMapDataSource 。 若要使此示例正常工作,必须将下面的示例网站地图数据复制到名为 Web.sitemap 的文件。
<%@ 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" >
<!-- For the hover styles of the Menu control to -->
<!-- work correctly, you must include this head -->
<!-- element. -->
<head runat="server">
<title>Menu DataBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu DataBinding Example</h3>
<!-- Bind the Menu control to a SiteMapDataSource control. -->
<asp:menu id="NavigationMenu"
disappearafter="2000"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
font-names="Arial"
target="_blank"
datasourceid="MenuSource"
runat="server">
<staticmenuitemstyle backcolor="LightSteelBlue"
forecolor="Black"/>
<statichoverstyle backcolor="LightSkyBlue"/>
<dynamicmenuitemstyle backcolor="Black"
forecolor="Silver"/>
<dynamichoverstyle backcolor="LightSkyBlue"
forecolor="Black"/>
</asp:menu>
<asp:SiteMapDataSource id="MenuSource"
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" >
<!-- For the hover styles of the Menu control to -->
<!-- work correctly, you must include this head -->
<!-- element. -->
<head runat="server">
<title>Menu DataBinding Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu DataBinding Example</h3>
<!-- Bind the Menu control to a SiteMapDataSource control. -->
<asp:menu id="NavigationMenu"
disappearafter="2000"
staticdisplaylevels="2"
staticsubmenuindent="10"
orientation="Vertical"
font-names="Arial"
target="_blank"
datasourceid="MenuSource"
runat="server">
<staticmenuitemstyle backcolor="LightSteelBlue"
forecolor="Black"/>
<statichoverstyle backcolor="LightSkyBlue"/>
<dynamicmenuitemstyle backcolor="Black"
forecolor="Silver"/>
<dynamichoverstyle backcolor="LightSkyBlue"
forecolor="Black"/>
</asp:menu>
<asp:SiteMapDataSource id="MenuSource"
runat="server"/>
</form>
</body>
</html>
下面是上一示例的示例站点地图数据。
<siteMap>
<siteMapNode url="~\Home.aspx"
title="Home"
description="Home">
<siteMapNode url="~\Music.aspx"
title="Music"
description="Music">
<siteMapNode url="~\Classical.aspx"
title="Classical"
description="Classical"/>
<siteMapNode url="~\Rock.aspx"
title="Rock"
description="Rock"/>
<siteMapNode url="~\Jazz.aspx"
title="Jazz"
description="Jazz"/>
</siteMapNode>
<siteMapNode url="~\Movies.aspx"
title="Movies"
description="Movies">
<siteMapNode url="~\Action.aspx"
title="Action"
description="Action"/>
<siteMapNode url="~\Drama.aspx"
title="Drama"
description="Drama"/>
<siteMapNode url="~\Musical.aspx"
title="Musical"
description="Musical"/>
</siteMapNode>
</siteMapNode>
</siteMap>
注解
在本主题中:
介绍
该 Menu 控件用于在 ASP.NET 网页中显示菜单,并且通常与 SiteMapDataSource 用于导航网站的控件结合使用。 该 Menu 控件支持以下功能:
允许控件的菜单项绑定到层次结构数据源的数据绑定。
通过与控件的集成进行 SiteMapDataSource 网站导航。
以编程方式访问 Menu 对象模型以动态创建菜单、填充菜单项、设置属性等。
通过主题、用户定义的图像、样式和用户定义的模板自定义外观。
当用户单击菜单项时,控件 Menu 可以导航到链接的网页,或者直接发回服务器。 NavigateUrl如果设置了菜单项的属性,控件Menu将导航到链接页;否则,它会将页面发回服务器进行处理。 默认情况下,链接页显示在与控件相同的窗口或框架 Menu 中。 若要在不同的窗口或框架中显示链接的内容,请使用 Target 控件的属性 Menu 。
该 Menu 控件显示两种类型的菜单:静态菜单和动态菜单。 静态菜单始终显示在控件中 Menu 。 默认情况下,根级别(级别 0)的菜单项显示在静态菜单中。 可以通过设置 StaticDisplayLevels 属性在静态菜单中显示其他菜单级别(静态子菜单)。 菜单项(如果有)的级别高于属性指定的 StaticDisplayLevels 值显示在动态菜单中。 仅当用户将鼠标指针放在包含动态子菜单的父菜单项上时,才会显示动态菜单。 动态菜单在特定持续时间后自动消失。 使用属性 DisappearAfter 指定持续时间。
注释
当用户单击菜单外部时,动态菜单也会消失。
还可以通过设置 MaximumDynamicDisplayLevels 属性来限制动态菜单中显示的级别数。 将丢弃高于指定值的菜单级别。
注释
控件 Menu 未设计为在控件内 UpdatePanel 使用。 只能将 Menu 控件添加到控件外部 UpdatePanel 的页面。 UpdatePanel 控件用于更新页面的选定区域,而不是使用回发更新整个页面。 有关详细信息,请参阅 UpdatePanel 控件概述 和 Partial-Page 呈现概述。
菜单项
Menu控件由由对象表示MenuItem的菜单项树组成。 顶级(级别 0)的菜单项称为根菜单项。 具有父菜单项的菜单项称为子菜单项。 所有根菜单项都存储在集合中 Items 。 子菜单项存储在父菜单项的 ChildItems 集合中。
每个菜单项都有一 Text 个和一个 Value 属性。 属性的值 Text 显示在控件中 Menu ,而 Value 该属性用于存储有关菜单项的任何其他数据,例如传递给与菜单项关联的回发事件的数据。 单击后,菜单项可以导航到属性指示 NavigateUrl 的另一个网页。
注释
NavigateUrl如果未为菜单项设置属性,控件Menu只需将页面提交到服务器,以便在单击菜单项时进行处理。
还可以选择通过设置 ImageUrl 属性在菜单项中显示图像。
有关菜单项的详细信息,请参阅 MenuItem。
静态数据
控件最简单的数据模型 Menu 是静态菜单项。 若要使用声明性语法显示静态菜单项,请先在控件的Menu开始标记和结束标记之间嵌套打开和结束<Items>标记。 接下来,通过在开始标记和结束<Items>标记之间嵌套<asp:MenuItem>元素来创建菜单结构。 每个 <asp:MenuItem> 元素表示控件中的一个菜单项,并映射到对象 MenuItem 。 可以通过设置其 <asp:MenuItem> 元素的属性来设置每个菜单项的属性。 若要创建子菜单项,请在父菜单项的开始标记和结束<asp:MenuItem>标记之间嵌套其他<asp:MenuItem>元素。
绑定到数据
该 Menu 控件可以使用任何层次结构数据源控件,例如 XmlDataSource 控件或 SiteMapDataSource 控件。 若要绑定到层次结构数据源控件,请将 DataSourceID 控件的属性 Menu 设置为 ID 数据源控件的值。 该 Menu 控件自动绑定到指定的数据源控件。 这是绑定到数据的首选方法。
当绑定到每个数据项包含多个属性(如具有多个属性的 XML 元素)的数据源时,菜单项默认显示数据项方法返回 ToString 的值。 对于 XML 元素,菜单项显示元素名称,该名称显示菜单树的基础结构,但不十分有用。 可以使用集合指定菜单项绑定,将 DataBindings 菜单项绑定到特定的数据项属性。 该 DataBindings 集合包含定义 MenuItemBinding 数据项与绑定到的菜单项之间的关系的对象。 可以指定要在节点中显示的绑定条件和数据项属性。 有关菜单项绑定的详细信息,请参阅 MenuItemBinding。
不能通过将或TextField属性设置为Text空字符串(“)在控件中创建Menu空节点。 将这些属性设置为空字符串的效果与不设置属性的效果相同。 在这种情况下,该 Menu 控件使用 DataSource 属性创建默认绑定。 有关详细信息,请参阅 绑定到数据库。
自定义用户界面
可通过多种方式自定义控件的外观 Menu 。 首先,可以通过设置Orientation属性来指定控件是Menu水平呈现还是垂直呈现。 还可以为每个菜单项类型指定不同的样式(如字号和颜色)。
如果使用级联样式表(CSS)自定义控件的外观,请使用内联样式或单独的 CSS 文件,但不能同时使用这两者。 同时使用内联样式和单独的 CSS 文件可能会导致意外结果。 有关对控件使用样式表的详细信息,请参阅 Web 服务器控件和 CSS 样式。
下表列出了可用的菜单项样式。
| 菜单项样式属性 | 说明 |
|---|---|
| DynamicHoverStyle | 当鼠标指针置于动态菜单项上时,动态菜单项的样式设置。 |
| DynamicMenuItemStyle | 单个动态菜单项的样式设置。 |
| DynamicMenuStyle | 动态菜单的样式设置。 |
| DynamicSelectedStyle | 当前所选动态菜单项的样式设置。 |
| StaticHoverStyle | 鼠标指针放置在静态菜单项上的样式设置。 |
| StaticMenuItemStyle | 单个静态菜单项的样式设置。 |
| StaticMenuStyle | 静态菜单的样式设置。 |
| StaticSelectedStyle | 当前所选静态菜单项的样式设置。 |
可以使用以下样式集合指定应用于菜单项的样式,而不是设置单个样式属性。
| 级别样式集合 | 说明 |
|---|---|
| LevelMenuItemStyles | 一个 MenuItemStyle 对象集合,这些对象基于级别控制菜单项的样式。 |
| LevelSelectedStyles | 一个 MenuItemStyle 对象集合,这些对象基于级别控制所选菜单项的样式。 |
| LevelSubMenuStyles | 一个 MenuItemStyle 对象集合,这些对象基于级别控制子菜单项的样式。 |
集合中的第一个样式对应于菜单树中第一个深度级别的菜单项的样式。 集合中的第二个样式对应于菜单树中第二个深度级别的菜单项的样式,依如此。 这通常用于生成目录样式的导航菜单,其中特定深度的菜单项应具有相同的外观,无论它们是否具有子菜单。
注释
如果使用上表中列出的任意级别样式集合来定义控件的 Menu 样式,这些样式设置将替代单个菜单项样式属性。
更改控件外观的另一种方法是自定义控件中显示的 Menu 图像。 可以通过设置下表中显示的属性,为控件的不同部分指定自己的自定义映像。
| Image 属性 | 说明 |
|---|---|
| DynamicBottomSeparatorImageUrl | 动态菜单项底部显示的可选图像,用于将其与其他菜单项分开。 |
| DynamicPopOutImageUrl | 动态菜单项中显示的可选图像,指示它具有子菜单。 |
| DynamicTopSeparatorImageUrl | 动态菜单项顶部显示的可选图像,用于将其与其他菜单项分开。 |
| ScrollDownImageUrl | 显示在菜单项底部的图像,指示用户可以向下滚动以查看其他菜单项。 |
| ScrollUpImageUrl | 显示在菜单项顶部的图像,指示用户可以向上滚动以查看其他菜单项。 |
| StaticBottomSeparatorImageUrl | 静态菜单项底部显示的可选图像,用于将其与其他菜单项分开。 |
| StaticPopOutImageUrl | 静态菜单项中显示的可选图像,指示它具有子菜单。 |
| StaticTopSeparatorImageUrl | 静态菜单项顶部显示的可选图像,用于将其与其他菜单项分开。 |
若要完全控制用户界面(UI),可以使用以下模板属性为 Menu 控件定义自己的自定义模板。
| Template 属性 | 说明 |
|---|---|
| DynamicItemTemplate | 包含要为动态菜单项呈现的自定义内容的模板。 |
| StaticItemTemplate | 包含要为静态菜单项呈现的自定义内容的模板。 |
可以通过分别设置 DynamicVerticalOffset 和属性来控制动态菜单相对于其父菜单项的垂直和 DynamicHorizontalOffset 水平位置。 若要控制静态菜单中静态子菜单项的缩进,请使用该 StaticSubMenuIndent 属性。
事件
该 Menu 控件提供了可对其编程的多个事件。 这样,就可以在事件发生时运行自定义例程。 下表列出了受支持的事件。
| 事件 | 说明 |
|---|---|
| MenuItemClick | 单击菜单项时发生。 此事件通常用于将控件与页面上的另一个控件同步 Menu 。 |
| MenuItemDataBound | 当菜单项绑定到数据时发生。 此事件通常用于在控件中 Menu 呈现菜单项之前对其进行修改。 |
可及性
有关如何配置此控件以便生成符合辅助功能标准的标记的信息,请参阅 Visual Studio 中的辅助功能以及 ASP.NET 和 ASP.NET 控件和辅助功能。
声明性语法
<asp:Menu
AccessKey="string"
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
Inset|Outset"
BorderWidth="size"
CssClass="string"
DataSource="string"
DataSourceID="string"
DisappearAfter="integer"
DynamicBottomSeparatorImageUrl="uri"
DynamicEnableDefaultPopOutImage="True|False"
DynamicHorizontalOffset="integer"
DynamicItemFormatString="string"
DynamicPopOutImageTextFormatString="string"
DynamicPopOutImageUrl="uri"
DynamicTopSeparatorImageUrl="uri"
DynamicVerticalOffset="integer"
Enabled="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
ID="string"
ItemWrap="True|False"
MaximumDynamicDisplayLevels="integer"
OnDataBinding="DataBinding event handler"
OnDataBound="DataBound event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnMenuItemClick="MenuItemClick event handler"
OnMenuItemDataBound="MenuItemDataBound event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
Orientation="Horizontal|Vertical"
PathSeparator="string"
runat="server"
ScrollDownImageUrl="uri"
ScrollDownText="string"
ScrollUpImageUrl="uri"
ScrollUpText="string"
SkinID="string"
SkipLinkText="string"
StaticBottomSeparatorImageUrl="uri"
StaticDisplayLevels="integer"
StaticEnableDefaultPopOutImage="True|False"
StaticItemFormatString="string"
StaticPopOutImageTextFormatString="string"
StaticPopOutImageUrl="uri"
StaticSubMenuIndent="size"
StaticTopSeparatorImageUrl="uri"
Style="string"
TabIndex="integer"
Target="string"
ToolTip="string"
Visible="True|False"
Width="size"
>
<DataBindings>
<asp:MenuItemBinding
DataMember="string"
Depth="integer"
Enabled="True|False"
EnabledField="string"
FormatString="string"
ImageUrl="uri"
ImageUrlField="string"
NavigateUrl="uri"
NavigateUrlField="string"
PopOutImageUrl="uri"
PopOutImageUrlField="string"
Selectable="True|False"
SelectableField="string"
SeparatorImageUrl="uri"
SeparatorImageUrlField="string"
Target="string"
TargetField="string"
Text="string"
TextField="string"
ToolTip="string"
ToolTipField="string"
Value="string"
ValueField="string"
/>
</DataBindings>
<DynamicHoverStyle />
<DynamicItemTemplate>
<!-- child controls -->
</DynamicItemTemplate>
<DynamicMenuItemStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
ItemSpacing="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
<DynamicMenuStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
<DynamicSelectedStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
ItemSpacing="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
<Items />
<LevelMenuItemStyles>
<asp:MenuItemStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|
Double|Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|
X-Small|Small|Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
ItemSpacing="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
</LevelMenuItemStyles>
<LevelSelectedStyles>
<asp:MenuItemStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|
Double|Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|
X-Small|Small|Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
ItemSpacing="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
</LevelSelectedStyles>
<LevelSubMenuStyles>
<asp:SubMenuStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|
Double|Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|
X-Small|Small|Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
</LevelSubMenuStyles>
<StaticHoverStyle />
<StaticItemTemplate>
<!-- child controls -->
</StaticItemTemplate>
<StaticMenuItemStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|
X-Small|Small|Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
ItemSpacing="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
<StaticMenuStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
<StaticSelectedStyle
BackColor="color name|#dddddd"
BorderColor="color name|#dddddd"
BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|
Groove|Ridge|Inset|Outset"
BorderWidth="size"
CssClass="string"
Font-Bold="True|False"
Font-Italic="True|False"
Font-Names="string"
Font-Overline="True|False"
Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
Medium|Large|X-Large|XX-Large"
Font-Strikeout="True|False"
Font-Underline="True|False"
ForeColor="color name|#dddddd"
Height="size"
HorizontalPadding="size"
ItemSpacing="size"
OnDisposed="Disposed event handler"
VerticalPadding="size"
Width="size"
/>
</asp:Menu>
构造函数
| 名称 | 说明 |
|---|---|
| Menu() |
初始化 Menu 类的新实例。 |
字段
| 名称 | 说明 |
|---|---|
| MenuItemClickCommandName |
包含命令名称。 |
属性
| 名称 | 说明 |
|---|---|
| AccessKey |
获取或设置访问密钥,使你能够快速导航到 Web 服务器控件。 (继承自 WebControl) |
| Adapter |
获取控件的特定于浏览器的适配器。 (继承自 Control) |
| AppRelativeTemplateSourceDirectory |
获取或设置包含此控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control) |
| Attributes |
获取不对应于控件上的属性的任意属性(仅用于呈现)的集合。 (继承自 WebControl) |
| BackColor |
获取或设置 Web 服务器控件的背景色。 (继承自 WebControl) |
| BindingContainer |
获取包含此控件的数据绑定的控件。 (继承自 Control) |
| BorderColor |
获取或设置 Web 控件的边框颜色。 (继承自 WebControl) |
| BorderStyle |
获取或设置 Web 服务器控件的边框样式。 (继承自 WebControl) |
| BorderWidth |
获取或设置 Web 服务器控件的边框宽度。 (继承自 WebControl) |
| ChildControlsCreated |
获取一个值,该值指示是否已创建服务器控件的子控件。 (继承自 Control) |
| ClientID |
获取由 ASP.NET 生成的 HTML 标记的控件 ID。 (继承自 Control) |
| ClientIDMode |
获取或设置用于生成属性值的 ClientID 算法。 (继承自 Control) |
| ClientIDSeparator |
获取一个表示属性中使用的 ClientID 分隔符的字符值。 (继承自 Control) |
| Context |
HttpContext获取与当前 Web 请求的服务器控件关联的对象。 (继承自 Control) |
| Controls |
获取一个 ControlCollection 包含控件的 Menu 子控件。 |
| ControlStyle |
获取 Web 服务器控件的样式。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| ControlStyleCreated |
获取一个值,该值 Style 指示是否已为 ControlStyle 属性创建对象。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| CssClass |
获取或设置由客户端上的 Web 服务器控件呈现的级联样式表 (CSS) 类。 (继承自 WebControl) |
| DataBindings |
获取一个 MenuItemBinding 对象集合,这些对象定义数据项与它绑定到的菜单项之间的关系。 |
| DataItemContainer |
获取对命名容器的引用(如果命名容器实现 IDataItemContainer)。 (继承自 Control) |
| DataKeysContainer |
获取对命名容器的引用(如果命名容器实现 IDataKeysControl)。 (继承自 Control) |
| DataSource |
获取或设置数据绑定控件从中检索其数据项列表的对象。 (继承自 BaseDataBoundControl) |
| DataSourceID |
获取或设置数据绑定控件从中检索其数据项列表的控件的 ID。 (继承自 HierarchicalDataBoundControl) |
| DesignMode |
获取一个值,该值指示控件是否在设计图面上使用。 (继承自 Control) |
| DisappearAfter |
获取或设置在鼠标指针不再定位在菜单上之后显示动态菜单的持续时间。 |
| DynamicBottomSeparatorImageUrl |
获取或设置要显示在每个动态菜单项底部的图像的 URL,以将其与其他菜单项分开。 |
| DynamicEnableDefaultPopOutImage |
获取或设置一个值,该值指示是否显示动态菜单项的内置图像。 |
| DynamicHorizontalOffset |
获取或设置相对于其父菜单项水平移动动态菜单的像素数。 |
| DynamicHoverStyle |
获取对 Style 对象的引用,该对象允许在鼠标指针置于该对象上时设置动态菜单项的外观。 |
| DynamicItemFormatString |
获取或设置与动态显示的所有菜单项一起显示的其他文本。 |
| DynamicItemTemplate |
获取或设置包含要为动态菜单呈现的自定义内容的模板。 |
| DynamicMenuItemStyle |
获取对 MenuItemStyle 对象的引用,该对象允许设置动态菜单中菜单项的外观。 |
| DynamicMenuStyle |
获取对 MenuItemStyle 对象的引用,该对象允许设置动态菜单的外观。 |
| DynamicPopOutImageTextFormatString |
获取或设置用于指示动态菜单项具有子菜单的图像的备用文本。 |
| DynamicPopOutImageUrl |
获取或设置动态菜单项具有子菜单时显示在动态菜单项中的自定义图像的 URL。 |
| DynamicSelectedStyle |
获取对 MenuItemStyle 对象的引用,该对象允许您设置用户选择的动态菜单项的外观。 |
| DynamicTopSeparatorImageUrl |
获取或设置要显示在每个动态菜单项顶部的图像的 URL,以将其与其他菜单项分开。 |
| DynamicVerticalOffset |
获取或设置相对于其父菜单项垂直移动动态菜单的像素数。 |
| Enabled |
获取或设置一个值,该值指示是否启用 Web 服务器控件。 (继承自 WebControl) |
| EnableTheming |
获取或设置一个值,该值指示主题是否应用于此控件。 (继承自 WebControl) |
| EnableViewState |
获取或设置一个值,该值指示服务器控件是否将视图状态及其包含的任何子控件的视图状态保存到请求客户端。 (继承自 Control) |
| Events |
获取控件的事件处理程序委托的列表。 此属性为只读。 (继承自 Control) |
| Font |
获取与 Web 服务器控件关联的字体属性。 (继承自 WebControl) |
| ForeColor |
获取或设置 Web 服务器控件的前景色(通常是文本的颜色)。 (继承自 WebControl) |
| HasAttributes |
获取一个值,该值指示控件是否设置了属性。 (继承自 WebControl) |
| HasChildViewState |
获取一个值,该值指示当前服务器控件的子控件是否具有保存的视图状态设置。 (继承自 Control) |
| Height |
获取或设置 Web 服务器控件的高度。 (继承自 WebControl) |
| ID |
获取或设置分配给服务器控件的编程标识符。 (继承自 Control) |
| IdSeparator |
获取用于分隔控件标识符的字符。 (继承自 Control) |
| IncludeStyleBlock |
获取或设置一个值,该值指示 ASP.NET 是否应呈现菜单中使用的样式的级联样式表 (CSS) 定义块。 |
| Initialized |
获取一个值,该值指示是否已初始化数据绑定控件。 (继承自 BaseDataBoundControl) |
| IsBoundUsingDataSourceID |
获取一个值,该值指示是否已 DataSourceID 设置属性。 (继承自 BaseDataBoundControl) |
| IsChildControlStateCleared |
获取一个值,该值指示此控件中包含的控件是否具有控件状态。 (继承自 Control) |
| IsDataBindingAutomatic |
获取一个值,该值指示数据绑定是否自动。 (继承自 BaseDataBoundControl) |
| IsEnabled |
获取一个值,该值指示是否启用控件。 (继承自 WebControl) |
| IsTrackingViewState |
获取一个值,该值指示服务器控件是否正在保存对其视图状态的更改。 (继承自 Control) |
| IsUsingModelBinders |
在派生类中实现时,获取一个值,该值指示控件是否使用模型绑定器。 (继承自 BaseDataBoundControl) |
| IsViewStateEnabled |
获取一个值,该值指示是否为此控件启用视图状态。 (继承自 Control) |
| Items |
获取一个 MenuItemCollection 对象,该对象包含控件中的所有 Menu 菜单项。 |
| ItemWrap |
获取或设置一个值,该值指示菜单项的文本是否应换行。 |
| LevelMenuItemStyles |
获取一个 MenuItemStyleCollection 对象,该对象包含基于控件中的级别应用于菜单项的 Menu 样式设置。 |
| LevelSelectedStyles |
获取一个 MenuItemStyleCollection 对象,该对象包含基于控件中的级别应用于所选菜单项的 Menu 样式设置。 |
| LevelSubMenuStyles |
获取一个 MenuItemStyleCollection 对象,该对象包含基于控件中的级别应用于静态菜单中的子菜单项的 Menu 样式设置。 |
| LoadViewStateByID |
获取一个值,该值指示控件是否参与加载其视图状态,而不是 ID 索引。 (继承自 Control) |
| MaximumDynamicDisplayLevels |
获取或设置要为动态菜单呈现的菜单级别数。 |
| NamingContainer |
获取对服务器控件命名容器的引用,该容器创建唯一的命名空间,用于区分具有相同 ID 属性值的服务器控件。 (继承自 Control) |
| Orientation |
获取或设置要呈现 Menu 控件的方向。 |
| Page |
获取对 Page 包含服务器控件的实例的引用。 (继承自 Control) |
| Parent |
获取对页面控件层次结构中服务器控件的父控件的引用。 (继承自 Control) |
| PathSeparator |
获取或设置用于分隔控件中菜单项的路径的 Menu 字符。 |
| RenderingCompatibility |
获取一个值,该值指定呈现的 HTML 将与 ASP.NET 版本兼容。 (继承自 Control) |
| RenderingMode |
获取或设置一个值,该值指定控件是呈现 HTML |
| RequiresDataBinding |
获取或设置一个值,该值指示是否 DataBind() 应调用该方法。 (继承自 BaseDataBoundControl) |
| ScrollDownImageUrl |
获取或设置动态菜单中显示的图像的 URL,以指示用户可以向下滚动以获取其他菜单项。 |
| ScrollDownText |
获取或设置属性中指定的图像的 ScrollDownImageUrl 备用文本。 |
| ScrollUpImageUrl |
获取或设置动态菜单中显示的图像的 URL,以指示用户可以向上滚动以获取其他菜单项。 |
| ScrollUpText |
获取或设置属性中指定的图像的 ScrollUpImageUrl 备用文本。 |
| SelectedItem |
获取所选菜单项。 |
| SelectedValue |
获取所选菜单项的值。 |
| Site |
获取有关在设计图面上呈现时承载当前控件的容器的信息。 (继承自 Control) |
| SkinID |
获取或设置要应用于控件的皮肤。 (继承自 WebControl) |
| SkipLinkText |
获取或设置屏幕阅读器读取的隐藏图像的备用文本,以提供跳过链接列表的功能。 |
| StaticBottomSeparatorImageUrl |
获取或设置每个静态菜单项底部显示为分隔符的图像的 URL。 |
| StaticDisplayLevels |
获取或设置要显示在静态菜单中的菜单级别数。 |
| StaticEnableDefaultPopOutImage |
获取或设置一个值,该值指示是否显示内置图像以指示静态菜单项具有子菜单。 |
| StaticHoverStyle |
获取对 Style 对象的引用,该对象允许在鼠标指针置于该对象上时设置静态菜单项的外观。 |
| StaticItemFormatString |
获取或设置以静态方式显示的所有菜单项显示的其他文本。 |
| StaticItemTemplate |
获取或设置包含要为静态菜单呈现的自定义内容的模板。 |
| StaticMenuItemStyle |
获取对 MenuItemStyle 对象的引用,该对象允许设置静态菜单中菜单项的外观。 |
| StaticMenuStyle |
获取对 MenuItemStyle 对象的引用,该对象允许设置静态菜单的外观。 |
| StaticPopOutImageTextFormatString |
获取或设置用于指示静态菜单项具有子菜单的弹出图像的备用文本。 |
| StaticPopOutImageUrl |
获取或设置显示的图像的 URL,以指示静态菜单项具有子菜单。 |
| StaticSelectedStyle |
获取对 MenuItemStyle 对象的引用,该对象允许设置用户在静态菜单中选择的菜单项的外观。 |
| StaticSubMenuIndent |
获取或设置静态菜单中缩进子菜单的空间量(以像素为单位)。 |
| StaticTopSeparatorImageUrl |
获取或设置每个静态菜单项顶部显示为分隔符的图像的 URL。 |
| Style |
获取文本属性的集合,该属性将在 Web 服务器控件的外部标记上呈现为样式属性。 (继承自 WebControl) |
| SupportsDisabledAttribute |
获取一个值,该值指示当控件的属性为控件的属性时,控件是否应将呈现的 IsEnabled HTML 元素的属性 |
| TabIndex |
获取或设置 Web 服务器控件的选项卡索引。 (继承自 WebControl) |
| TagKey |
HtmlTextWriterTag获取与Menu控件对应的值。 此属性主要由控件开发人员使用。 |
| TagName |
获取控件标记的名称。 此属性主要由控件开发人员使用。 (继承自 WebControl) |
| Target |
获取或设置要在其中显示与菜单项关联的网页内容的目标窗口或框架。 |
| TemplateControl |
获取或设置对包含此控件的模板的引用。 (继承自 Control) |
| TemplateSourceDirectory |
获取包含当前服务器控件的 Page 虚拟 UserControl 目录。 (继承自 Control) |
| ToolTip |
获取或设置鼠标指针悬停在 Web 服务器控件上时显示的文本。 (继承自 WebControl) |
| UniqueID |
获取服务器控件的唯一分层限定标识符。 (继承自 Control) |
| ValidateRequestMode |
获取或设置一个值,该值指示控件是否检查浏览器的客户端输入是否存在潜在危险值。 (继承自 Control) |
| ViewState |
获取状态信息的字典,该字典允许跨同一页的多个请求保存和还原服务器控件的视图状态。 (继承自 Control) |
| ViewStateIgnoresCase |
获取一个值,该值指示对象是否 StateBag 不区分大小写。 (继承自 Control) |
| ViewStateMode |
获取或设置此控件的视图状态模式。 (继承自 Control) |
| Visible |
获取或设置一个值,该值指示服务器控件是否呈现为页面上的 UI。 (继承自 Control) |
| Width |
获取或设置 Web 服务器控件的宽度。 (继承自 WebControl) |
方法
活动
| 名称 | 说明 |
|---|---|
| DataBinding |
当服务器控件绑定到数据源时发生。 (继承自 Control) |
| DataBound |
在服务器控件绑定到数据源之后发生。 (继承自 BaseDataBoundControl) |
| Disposed |
在从内存中释放服务器控件时发生,这是请求 ASP.NET 页时服务器控件生命周期的最后阶段。 (继承自 Control) |
| Init |
在初始化服务器控件时发生,这是其生命周期中的第一步。 (继承自 Control) |
| Load |
在将服务器控件加载到对象中 Page 时发生。 (继承自 Control) |
| MenuItemClick |
单击控件中的 Menu 菜单项时发生。 |
| MenuItemDataBound |
当控件中的 Menu 菜单项绑定到数据时发生。 |
| PreRender |
在 Control 加载对象但在呈现之前发生。 (继承自 Control) |
| Unload |
从内存中卸载服务器控件时发生。 (继承自 Control) |
显式接口实现
扩展方法
| 名称 | 说明 |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
为指定的数据控件启用动态数据行为。 |
| EnableDynamicData(INamingContainer, Type, Object) |
为指定的数据控件启用动态数据行为。 |
| EnableDynamicData(INamingContainer, Type) |
为指定的数据控件启用动态数据行为。 |
| EnablePersistedSelection(BaseDataBoundControl) |
已过时.
允许选择保留在支持选择和分页的数据控件中。 |
| FindDataSourceControl(Control) |
返回与指定控件的数据控件关联的数据源。 |
| FindFieldTemplate(Control, String) |
返回指定控件命名容器中指定列的字段模板。 |
| FindMetaTable(Control) |
返回包含数据控件的元表对象。 |
| GetDefaultValues(INamingContainer) |
获取指定数据控件的默认值的集合。 |
| GetMetaTable(INamingContainer) |
获取指定数据控件的表元数据。 |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
设置指定数据控件的表元数据和默认值映射。 |
| SetMetaTable(INamingContainer, MetaTable, Object) |
设置指定数据控件的表元数据和默认值映射。 |
| SetMetaTable(INamingContainer, MetaTable) |
设置指定数据控件的表元数据。 |
| TryGetMetaTable(INamingContainer, MetaTable) |
确定表元数据是否可用。 |