Menu 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
顯示 ASP.NET Web 網頁中的功能表。
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
- 繼承
- 屬性
- 實作
範例
具有原始程式碼的 Visual Studio 網站專案隨附于本主題: 下載。
下列程式碼範例示範如何使用宣告式語法, 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 控制項概觀 和 部分頁面轉譯概觀。
功能表項目
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 。
您無法在 控制項中 Menu 建立空白節點, Text 方法是將 或 TextField 屬性設定為空字串 (「」「) 。 將這些屬性設定為空字串的效果與未設定屬性的效果相同。 在此情況下, 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 轉譯功能表項目之前修改。 |
Accessibility
如需如何設定此控制項以產生符合協助工具標準的標記的相關資訊,請參閱 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 |
取得或設定便捷鍵 (Access Key),可讓您快速巡覽至 Web 伺服器控制項。 (繼承來源 WebControl) |
Adapter |
針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control) |
AppRelativeTemplateSourceDirectory |
取得或設定包含了此控制項之 Page 或 UserControl 物件的相對應用程式虛擬目錄。 (繼承來源 Control) |
Attributes |
取得任意屬性 (Attribute) 的集合 (只供呈現),不與控制項上的屬性 (Property) 對應。 (繼承來源 WebControl) |
BackColor |
取得或設定 Web 伺服器控制項的背景色彩。 (繼承來源 WebControl) |
BindingContainer |
取得包含了此控制項之資料繫結的控制項。 (繼承來源 Control) |
BorderColor |
取得或設定 Web 控制項的框線色彩。 (繼承來源 WebControl) |
BorderStyle |
取得或設定 Web 伺服器控制項的框線樣式。 (繼承來源 WebControl) |
BorderWidth |
取得或設定 Web 伺服器控制項的框線寬度。 (繼承來源 WebControl) |
ChildControlsCreated |
取得值,指出是否已經建立伺服器控制項的子控制項。 (繼承來源 Control) |
ClientID |
取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。 (繼承來源 Control) |
ClientIDMode |
取得或設定用來產生 ClientID 屬性值的演算法。 (繼承來源 Control) |
ClientIDSeparator |
取得字元值,表示在 ClientID 屬性中所使用的分隔字元。 (繼承來源 Control) |
Context |
取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。 (繼承來源 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 |
取得或設定控制項的識別碼,資料繫結控制項會由此擷取其項目清單。 (繼承來源 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 |
取得控制項事件處理常式委派 (Delegate) 的清單。 這個屬性是唯讀的。 (繼承來源 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 |
取得或設定值,這個值指定 Menu 控制項會呈現 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 |
取得值,這個值表示當控制項的 |
TabIndex |
取得或設定 Web 伺服器控制項的定位索引。 (繼承來源 WebControl) |
TagKey |
取得對應於 HtmlTextWriterTag 控制項的 Menu 值。 這個屬性主要由控制項開發人員使用。 |
TagName |
取得控制項標記的名稱。 這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl) |
Target |
取得或設定要顯示與功能表項目關聯之 Web 網頁內容的目標視窗或框架。 |
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) |
明確介面實作
擴充方法
EnablePersistedSelection(BaseDataBoundControl) |
已淘汰.
啟用要保存於資料控制項中且支援選取和分頁的選項。 |
FindDataSourceControl(Control) |
傳回與指定之控制項的資料控制項相關聯的資料來源。 |
FindFieldTemplate(Control, String) |
傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。 |
FindMetaTable(Control) |
傳回包含資料控制項的中繼資料表物件。 |
GetDefaultValues(INamingContainer) |
取得所指定資料控制項的預設值集合。 |
GetMetaTable(INamingContainer) |
取得所指定資料控制項中的資料表中繼資料。 |
SetMetaTable(INamingContainer, MetaTable) |
設定所指定資料控制項中的資料表中繼資料。 |
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
設定所指定資料控制項的資料表中繼資料及預設值對應。 |
SetMetaTable(INamingContainer, MetaTable, Object) |
設定所指定資料控制項的資料表中繼資料及預設值對應。 |
TryGetMetaTable(INamingContainer, MetaTable) |
判斷資料表中繼資料是否可供使用。 |
EnableDynamicData(INamingContainer, Type) |
針對指定的資料控制項啟用動態資料行為。 |
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
針對指定的資料控制項啟用動態資料行為。 |
EnableDynamicData(INamingContainer, Type, Object) |
針對指定的資料控制項啟用動態資料行為。 |
適用於
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應