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 項中。 預設情況下,根級(level 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>標籤。 接著,透過將 <asp:MenuItem> 元素置巢於開門與關閉 <Items> 標籤之間來建立選單結構。 每個 <asp:MenuItem> 元素代表控制項中的選單項目,並映射到一個 MenuItem 物件。 你可以透過設定每個選單項目的屬性來設定其 <asp:MenuItem> 屬性。 要建立子選單項目,可以在父選單項目的開頭與關閉<asp:MenuItem>標籤之間巢狀額外<asp:MenuItem>元素。
綁定資料
控制 Menu 項可以使用任何階層式資料來源控制,例如控制 XmlDataSource 項或控制 SiteMapDataSource 項。 要綁定到階層式資料來源控制,請將控制項的Menu屬性設DataSourceID為ID該資料來源控制項的值。 控制項 Menu 會自動綁定到指定的資料來源控制。 這是綁定資料的首選方法。
當綁定到每個資料項目包含多個屬性的資料來源(例如帶有多個屬性的 XML 元素)時,選單項目預設會顯示該資料項目的方法 ToString 回傳的值。 以 XML 元素為例,選單項目會顯示元素名稱,這顯示選單樹的底層結構,但除此之外並不太實用。 你可以利用 DataBindings 集合指定選單項目綁定,將選單項目綁定到特定的資料項目屬性。 該 DataBindings 集合包含 MenuItemBinding 定義資料項目與其綁定選單項目關係的物件。 你可以指定綁定條件以及要在節點中顯示的資料項目屬性。 欲了解更多關於選單項目裝訂的資訊,請參見 MenuItemBinding。
你無法透過將 or TextField 屬性設定Text為空字串(“”)來建立控制Menu節點。 將這些屬性設為空字串,效果與未設定屬性相同。 在這種情況下,控制 Menu 項會根據該 DataSource 屬性建立預設綁定。 欲了解更多資訊,請參閱「 與資料庫綁定」。
自訂使用者介面
有許多方式可以自訂控制器的 Menu 外觀。 首先,你可以透過設定Orientation屬性來指定控制項是Menu橫向還是垂直渲染。 你也可以為每種選單項目類型指定不同的樣式(例如字型大小和顏色)。
如果你使用層疊樣式表(CSS)來自訂控制項的外觀,請使用內嵌樣式或獨立的 CSS 檔案,但不要兩者兼用。 同時使用內嵌樣式和獨立的 CSS 檔案可能會產生意想不到的結果。 欲了解更多有關使用樣式表與控制項的資訊,請參閱 網頁伺服器控制項與 CSS 樣式。
下表列出可用的菜單項目樣式。
| 選單項目樣式屬性 | 說明 |
|---|---|
| DynamicHoverStyle | 當滑鼠指標放在動態選單項目上時的樣式設定。 |
| DynamicMenuItemStyle | 針對單一動態選單項目的樣式設定。 |
| DynamicMenuStyle | 動態選單的樣式設定。 |
| DynamicSelectedStyle | 目前選取動態選單項目的樣式設定。 |
| StaticHoverStyle | 當滑鼠指標放在靜態選單項目上時的樣式設定。 |
| StaticMenuItemStyle | 針對單一靜態選單項目的樣式設定。 |
| StaticMenuStyle | 靜態選單的樣式設定。 |
| StaticSelectedStyle | 目前選擇的靜態選單項目的樣式設定。 |
你可以不用設定個別樣式屬性,而是根據選單的等級指定套用到選單項目的樣式,方法是使用以下樣式集合。
| 關卡風格集合 | 說明 |
|---|---|
| LevelMenuItemStyles | 一組 MenuItemStyle 物件,能在關卡中控制選單項目的風格。 |
| LevelSelectedStyles | 一組 MenuItemStyle 物件,能在關卡上控制選單項目的樣式。 |
| LevelSubMenuStyles | 一組 MenuItemStyle 物件,依關卡控制子選單項目的樣式。 |
集合中的第一個樣式對應於選單樹中第一個深度層級的選單項目樣式。 集合中的第二個樣式對應於選單樹中第二個深度層級的選單項目樣式,依此類推。 這通常用於產生目錄式的導覽選單,讓某個深度的選單項目無論是否有子選單,都應該呈現相同的外觀。
備註
如果你使用前一表中列出的任何關卡風格集合來定義控制項的風格 Menu ,這些風格設定會覆蓋個別選單項目的風格屬性。
另一種改變控制項外觀的方法是自訂控制項中 Menu 顯示的影像。 你可以透過設定下表所示的屬性,為控制項的不同部分指定自訂映像。
| 影像屬性 | 說明 |
|---|---|
| DynamicBottomSeparatorImageUrl | 動態選單項目底部顯示的可選圖片,用以區分它與其他選單項目。 |
| DynamicPopOutImageUrl | 動態選單項目中顯示的可選圖片,表示有子選單。 |
| DynamicTopSeparatorImageUrl | 動態選單項目頂部顯示的可選圖片,用以區分它與其他選單項目。 |
| ScrollDownImageUrl | 該圖片顯示於選單項目底部,表示使用者可向下捲動查看更多選單項目。 |
| ScrollUpImageUrl | 該圖片顯示於選單項目頂端,表示使用者可向上捲動以查看更多選單項目。 |
| StaticBottomSeparatorImageUrl | 在靜態選單項目底部顯示一個可選圖片,用來區分它與其他選單項目。 |
| StaticPopOutImageUrl | 在靜態選單項目中顯示的可選圖片,表示有子選單。 |
| StaticTopSeparatorImageUrl | 在靜態選單項目頂部顯示的可選圖片,用以區分它與其他選單項目。 |
為了完全控制使用者介面(UI),您可以使用以下範本屬性來自訂 Menu 控制範本。
| 範本屬性 | 說明 |
|---|---|
| DynamicItemTemplate | 包含動態選單項目要渲染的自訂內容的範本。 |
| StaticItemTemplate | 包含靜態選單項目要渲染的自訂內容的範本。 |
你可以透過設定 DynamicVerticalOffset 和 DynamicHorizontalOffset 屬性來控制動態選單相對於父選單項目的垂直與水平位置。 要控制靜態選單中靜態子選單項目的縮排,請使用屬性 StaticSubMenuIndent 。
活動
控制系統 Menu 提供多個事件,你可以針對這些事件進行程式設計。 這讓你能在事件發生時執行自訂例程。 下表列出了支持的事件。
| 事件 | 說明 |
|---|---|
| MenuItemClick | 當點擊選單項目時會發生。 此事件常用於同步 Menu 頁面上的一個控制項與另一個控制項。 |
| MenuItemDataBound | 當選單項目綁定到資料時會發生。 此事件通常用於在選單項目渲染於 Menu 控制項前進行修改。 |
無障礙設施
關於如何配置此控制項以產生符合無障礙標準的標記,請參閱 Visual Studio 中的無障礙,ASP.NETASP.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>
建構函式
| 名稱 | Description |
|---|---|
| Menu() |
初始化 Menu 類別的新執行個體。 |
欄位
| 名稱 | Description |
|---|---|
| MenuItemClickCommandName |
包含指令名稱。 |
屬性
| 名稱 | Description |
|---|---|
| AccessKey |
取得或設定存取金鑰,讓你能快速導航到網頁伺服器控制。 (繼承來源 WebControl) |
| Adapter |
拿到瀏覽器專用的控制器轉接器。 (繼承來源 Control) |
| AppRelativeTemplateSourceDirectory |
取得或設定包含此控制項的 or UserControl 物件的Page應用程式相對虛擬目錄。 (繼承來源 Control) |
| Attributes |
取得一組任意屬性(僅用於渲染),這些屬性與控制項上的屬性不對應。 (繼承來源 WebControl) |
| BackColor |
取得或設定網頁伺服器控制項的背景色。 (繼承來源 WebControl) |
| BindingContainer |
取得包含該控制項資料綁定的控制項。 (繼承來源 Control) |
| BorderColor |
取得或設定網頁控制的邊框顏色。 (繼承來源 WebControl) |
| BorderStyle |
取得或設定網頁伺服器控制的邊界樣式。 (繼承來源 WebControl) |
| BorderWidth |
取得或設定網頁伺服器控制的邊界寬度。 (繼承來源 WebControl) |
| ChildControlsCreated |
會取得一個值,表示伺服器控制項的子控制項是否已被建立。 (繼承來源 Control) |
| ClientID |
取得由 ASP.NET 產生的 HTML 標記的控制 ID。 (繼承來源 Control) |
| ClientIDMode |
取得或設定用於產生屬性值 ClientID 的演算法。 (繼承來源 Control) |
| ClientIDSeparator |
會得到一個字元值,代表該屬性中使用 ClientID 的分隔符字元。 (繼承來源 Control) |
| Context |
取得 HttpContext 與伺服器控制項相關聯的物件,用於目前的網頁請求。 (繼承來源 Control) |
| Controls |
會得到 ControlCollection 包含控制 Menu 項子控制項的 。 |
| ControlStyle |
這就有網頁伺服器控制的風格。 此特性主要由對照顯影劑使用。 (繼承來源 WebControl) |
| ControlStyleCreated |
會取得一個值,表示該屬性是否 Style 已建立 ControlStyle 物件。 此特性主要由控制顯影劑使用。 (繼承來源 WebControl) |
| CssClass |
取得或設定由網頁伺服器控制項在用戶端渲染的層疊樣式表(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 |
取得或設定一個值,表示網頁伺服器控制是否已啟用。 (繼承來源 WebControl) |
| EnableTheming |
取得或設定一個值,指示主題是否適用於此控制。 (繼承來源 WebControl) |
| EnableViewState |
取得或設定一個值,指示伺服器控制項是否能持久化其視圖狀態,以及其包含的任何子控制項的視圖狀態,給請求端客戶端。 (繼承來源 Control) |
| Events |
會取得一個事件處理代理清單來管理控制。 這個屬性是唯讀的。 (繼承來源 Control) |
| Font |
取得與網頁伺服器控制項相關的字型屬性。 (繼承來源 WebControl) |
| ForeColor |
取得或設定網頁伺服器控制項的前景顏色(通常是文字顏色)。 (繼承來源 WebControl) |
| HasAttributes |
會得到一個值,表示控制項是否設定了屬性。 (繼承來源 WebControl) |
| HasChildViewState |
會取得一個值,表示目前伺服器控制項的子控制項是否儲存了任何檢視狀態設定。 (繼承來源 Control) |
| Height |
取得或設定網頁伺服器控制的高度。 (繼承來源 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 |
會取得一個值,指示當控制項IsEnabled屬性為 |
| TabIndex |
取得或設定網頁伺服器控制的分頁索引。 (繼承來源 WebControl) |
| TagKey |
得到 HtmlTextWriterTag 對應控制 Menu 點的值。 此特性主要由對照顯影劑使用。 |
| TagName |
取得控制標籤名稱。 此特性主要由對照顯影劑使用。 (繼承來源 WebControl) |
| Target |
取得或設定目標視窗或框架,用以顯示與選單項目相關的網頁內容。 |
| TemplateControl |
取得或設定包含此控制項的範本參考。 (繼承來源 Control) |
| TemplateSourceDirectory |
取得包含當前伺服器控制權的 or UserControl 虛擬目錄Page。 (繼承來源 Control) |
| ToolTip |
當滑鼠指標懸停在網頁伺服器控制項上時,會取得或設定顯示的文字。 (繼承來源 WebControl) |
| UniqueID |
取得伺服器控制的唯一、階層限定的識別碼。 (繼承來源 Control) |
| ValidateRequestMode |
取得或設定一個值,指示控制器是否檢查瀏覽器的客戶端輸入是否有潛在危險的值。 (繼承來源 Control) |
| ViewState |
取得狀態資訊字典,讓你能儲存並還原伺服器控制的多個請求,針對同一頁面。 (繼承來源 Control) |
| ViewStateIgnoresCase |
會得到一個值,表示該物件是否 StateBag 不區分大小寫。 (繼承來源 Control) |
| ViewStateMode |
取得或設定此控制的視圖狀態模式。 (繼承來源 Control) |
| Visible |
取得或設定一個值,指示伺服器控制項是否以 UI 形式呈現在頁面上。 (繼承來源 Control) |
| Width |
取得或設定網頁伺服器控制的寬度。 (繼承來源 WebControl) |
方法
事件
| 名稱 | Description |
|---|---|
| DataBinding |
當伺服器控制項綁定到資料來源時會發生。 (繼承來源 Control) |
| DataBound |
發生在伺服器控制綁定到資料來源之後。 (繼承來源 BaseDataBoundControl) |
| Disposed |
當伺服器控制從記憶體中釋放時發生,這是伺服器控制生命週期中請求 ASP.NET 頁面的最後階段。 (繼承來源 Control) |
| Init |
發生在伺服器控制初始化時,這是其生命週期的第一步。 (繼承來源 Control) |
| Load |
當伺服器控制項載入 Page 物件時會發生。 (繼承來源 Control) |
| MenuItemClick |
當點擊控制項中的 Menu 選單項目時會發生。 |
| MenuItemDataBound |
當控制項中的選單項目 Menu 綁定到資料時會發生。 |
| PreRender |
發生在物件載入後 Control 但渲染之前。 (繼承來源 Control) |
| Unload |
當伺服器控制項從記憶體卸載時發生。 (繼承來源 Control) |
明確介面實作
擴充方法
| 名稱 | Description |
|---|---|
| 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) |
判斷表格中繼資料是否可用。 |