MenuAdapter 類別

定義

命名空間:

System.Web.UI.WebControls.Adapters

組件:

System.Web.dll

提供方法，可以修改特定瀏覽器的 Menu 控制項行為。

public ref class MenuAdapter : System::Web::UI::WebControls::Adapters::WebControlAdapter, System::Web::UI::IPostBackEventHandler

public class MenuAdapter : System.Web.UI.WebControls.Adapters.WebControlAdapter, System.Web.UI.IPostBackEventHandler

type MenuAdapter = class
    inherit WebControlAdapter
    interface IPostBackEventHandler

Public Class MenuAdapter
Inherits WebControlAdapter
Implements IPostBackEventHandler

繼承

Object

ControlAdapter

WebControlAdapter

MenuAdapter

實作

IPostBackEventHandler

備註

MenuAdapter會修改特定瀏覽器或瀏覽器類別之控件的Menu標記或行為，或做為某些功能的篩選。

根據預設， MenuItem 控件中的 Menu 物件會轉譯為超連結，以容納功能表流覽。 類別 Menu 會藉由實 IPostBackEventHandler 作 介面來維護狀態，以便在回傳期間回應和引發特定事件。 您可以擴充 MenuAdapter 類別，進一步自定義 控件的 Menu 轉譯或行為。

配接器的初始要求會使 .NET Framework 在要求瀏覽器的特性下搜尋控件的對應配接器。 類別 HttpBrowserCapabilities 會使用瀏覽器定義檔案來識別客戶端瀏覽器的特性，並將配接器對應至瀏覽器類型。

如需 ASP.NET 中自適性轉譯的詳細資訊，請參閱 調適型控件行為的架構概觀。

建構函式

MenuAdapter()

初始化 MenuAdapter 類別的新執行個體。

屬性

Browser	取得對用戶端瀏覽器功能的參考 (此用戶端是發出目前 HTTP 要求的用戶端)。 (繼承來源 ControlAdapter)
Control	擷取與這個 Menu 物件相關聯的 MenuAdapter 控制項的強型別參考。
IsEnabled	取得值，表示 Web 控制器及其所有父控制項是否都已啟用。 (繼承來源 WebControlAdapter)
Page	取得對頁面的參考 (與此配置器相關聯的控制項便存在於此頁面中)。 (繼承來源 ControlAdapter)
PageAdapter	取得對此頁的頁面配置器的參考 (關聯的控制項便存在於此頁面中)。 (繼承來源 ControlAdapter)

方法

BeginRender(HtmlTextWriter)	在呈現控制項之前呼叫。 在衍生的配置器類別中，產生特定目標所需的開頭標記 (而非 HTML 瀏覽器所需)。 (繼承來源 ControlAdapter)
CreateChildControls()	為複合控制項建立特定目標的子控制項。 (繼承來源 ControlAdapter)
EndRender(HtmlTextWriter)	在呈現控制項之後呼叫。 在衍生的配置器類別中，產生特定目標所需的結尾標記 (而非 HTML 瀏覽器所需)。 (繼承來源 ControlAdapter)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
LoadAdapterControlState(Object)	載入於先前要求頁面期間由 SaveAdapterControlState() 方法儲存的任何控制項狀態資訊。
LoadAdapterViewState(Object)	載入之前在對頁面發出要求的期間由 SaveAdapterViewState() 所儲存的配置器檢視狀態資訊 (與此控制項配置器相關聯的控制項便存在於此頁面中)。 (繼承來源 ControlAdapter)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnInit(EventArgs)	將關聯的 Menu 控制項登錄成需要控制項狀態。
OnLoad(EventArgs)	為關聯控制項覆寫 OnLoad(EventArgs) 方法。 (繼承來源 ControlAdapter)
OnPreRender(EventArgs)	為關聯的 OnPreRender(EventArgs) 控制項處理 Menu 方法。
OnUnload(EventArgs)	為關聯控制項覆寫 OnUnload(EventArgs) 方法。 (繼承來源 ControlAdapter)
RaisePostBackEvent(String)	在引發回傳事件時，用來維護功能表路徑。
Render(HtmlTextWriter)	為附加控制項配接器的控制項，產生目標特定的標記。 (繼承來源 WebControlAdapter)
RenderBeginTag(HtmlTextWriter)	加入標記屬性，並將控制項開頭標記 (Tag) 的標記 (Markup) 寫入至發出給瀏覽器或裝置的輸出資料流。
RenderChildren(HtmlTextWriter)	為複合控制項中的子控制項產生特定目標的標記 (控制項配置器會附加至此複合控制項)。 (繼承來源 ControlAdapter)
RenderContents(HtmlTextWriter)	以一連串超連結的方式，將關聯 Menu 控制項中的關聯功能表項目寫入至輸出資料流。
RenderEndTag(HtmlTextWriter)	建立最終標記 (Markup)，並將控制項之結尾標記 (Tag) 的標記 (Markup) 寫入至發出給瀏覽器或裝置的輸出資料流。
RenderItem(HtmlTextWriter, MenuItem, Int32)	將單一功能表項目呈現為超連結。
SaveAdapterControlState()	儲存自頁面回傳至伺服器之後發生的任何配置器私用控制項狀態變更。
SaveAdapterViewState()	儲存控制項配置器的檢視狀態資訊。 (繼承來源 ControlAdapter)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

IPostBackEventHandler.RaisePostBackEvent(String)

可讓 MenuAdapter 類別處理頁面回傳至伺服器時引發的事件。

另請參閱

• Menu
• WebControlAdapter
• AspNetHostingPermission
• HttpBrowserCapabilities
• 自適性控制行為的架構概觀