WebControlAdapter 類別

定義

命名空間:

System.Web.UI.WebControls.Adapters

組件:

System.Web.dll

自訂附加控制項配置器之 Web 控制項的呈現方式，以修改特定瀏覽器的預設標記或行為。

public ref class WebControlAdapter : System::Web::UI::Adapters::ControlAdapter

public class WebControlAdapter : System.Web.UI.Adapters.ControlAdapter

type WebControlAdapter = class
    inherit ControlAdapter

Public Class WebControlAdapter
Inherits ControlAdapter

繼承

Object

ControlAdapter

WebControlAdapter

衍生

System.Web.UI.WebControls.Adapters.DataBoundControlAdapter

System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter

System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter

System.Web.UI.WebControls.Adapters.MenuAdapter

備註

WebControl類別是 Web 控制項所繼承的基類。 它會定義所有 Web 控制項通用的許多屬性。 如需詳細資訊，請參閱WebControl。

WebControlAdapter物件是 WebControl 在其執行生命週期中替代特定類別或繼承方法和事件的元件，以允許瀏覽器或標記特定的處理。 .NET Framework 會 WebControl 針對每個用戶端要求，將單一控制項介面卡對應至衍生物件。

介面卡會修改特定瀏覽器或瀏覽器類別的控制項行為，或作為某些功能的任意篩選。 轉譯行為的大部分適應性都可以封裝在衍生自類別的特製化類別中 HtmlTextWriter 。 因此，您可能會使用單一介面卡來取得許多瀏覽器類別行為，或在類別中包含適應性，而 HtmlTextWriter 不需要使用控制項介面卡。

控制項本身不一定需要介面卡。 如果透過組合擴充控制項，則子控制項的介面卡通常就已足夠。

每個控制項都有透過瀏覽器定義檔案的明確對應至介面卡。 因此，對 Adapter 屬性的任何存取都會 WebControl 使用 HttpBrowserCapabilities 從瀏覽器定義檔解壓縮的物件來執行對應至介面卡對應的查詢。

在處理期間，.NET Framework 會攔截呼叫可覆寫的控制項，該方法可能是目標特定的控制項。 如果已連接控制項介面卡，.NET Framework 會呼叫相關聯的介面卡方法。 如需詳細資訊，請參閱ControlAdapter。

的轉譯 WebControl 通常包含開頭和結束記號，以及開始和結束標記之間的部分內部標記。 這些標記會在建立時定義 WebControl 。 如需詳細資訊，請參閱WebControl。

這些標記 RenderBeginTag 分別由和方法產生 RenderEndTag 。 內部標記是由方法所產生 RenderContents 。

Render方法會依下列順序呼叫方法來產生所有標記：

1. RenderBeginTag.

2. RenderContents.

3. RenderEndTag.

IsEnabled true 只有當 WebControl 和其所有父控制項都已啟用時，屬性才會傳回。 屬性會傳回 Control 的強型別參考 WebControl 。

建構函式

WebControlAdapter()

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

屬性

Browser	取得對用戶端瀏覽器功能的參考 (此用戶端是發出目前 HTTP 要求的用戶端)。 (繼承來源 ControlAdapter)
Control	取得附加這個控制項配置器的 Web 控制項的參考。
IsEnabled	取得值，表示 Web 控制器及其所有父控制項是否都已啟用。
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() 所儲存的配置器控制項狀態資訊 (與此控制項配置器相關聯的控制項便存在於此頁面中)。 (繼承來源 ControlAdapter)
LoadAdapterViewState(Object)	載入之前在對頁面發出要求的期間由 SaveAdapterViewState() 所儲存的配置器檢視狀態資訊 (與此控制項配置器相關聯的控制項便存在於此頁面中)。 (繼承來源 ControlAdapter)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
OnInit(EventArgs)	為關聯控制項覆寫 OnInit(EventArgs) 方法。 (繼承來源 ControlAdapter)
OnLoad(EventArgs)	為關聯控制項覆寫 OnLoad(EventArgs) 方法。 (繼承來源 ControlAdapter)
OnPreRender(EventArgs)	為關聯控制項覆寫 OnPreRender(EventArgs) 方法。 (繼承來源 ControlAdapter)
OnUnload(EventArgs)	為關聯控制項覆寫 OnUnload(EventArgs) 方法。 (繼承來源 ControlAdapter)
Render(HtmlTextWriter)	為附加控制項配接器的控制項，產生目標特定的標記。
RenderBeginTag(HtmlTextWriter)	建立傳送至目標瀏覽器 Web 控制項的標記 (Markup) 中的開頭標記 (Tag)。
RenderChildren(HtmlTextWriter)	為複合控制項中的子控制項產生特定目標的標記 (控制項配置器會附加至此複合控制項)。 (繼承來源 ControlAdapter)
RenderContents(HtmlTextWriter)	為附加控制項配置器的 Web 控制項產生特定目標內部標記。
RenderEndTag(HtmlTextWriter)	建立傳送至目標瀏覽器 Web 控制項的標記 (Markup) 中的結尾標記 (Tag)。
SaveAdapterControlState()	儲存控制項配置器的控制項狀態資訊。 (繼承來源 ControlAdapter)
SaveAdapterViewState()	儲存控制項配置器的檢視狀態資訊。 (繼承來源 ControlAdapter)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• ControlAdapter
• WebControl
• Control