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。
您無法藉由將 或 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 轉譯功能表項之前修改。 |
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) |
針對指定的資料控制項啟用動態資料行為。 |