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 适配器。

控件本身不一定需要适配器。 如果控件通过组合进行扩展，则子控件的适配器通常已足够。

每个控件都通过 .browser 定义文件显式映射到适配器。 因此，对 的 属性的任何访问都使用从 .browser 定义文件中提取的 对象来执行查找以控制 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)	在呈现控件前调用。 在派生的 adapter 类中，生成特定目标需要但 HTML 浏览器不需要的开始标记。 (继承自 ControlAdapter)
CreateChildControls()	为复合控件创建特定于目标的子控件。 (继承自 ControlAdapter)
EndRender(HtmlTextWriter)	在呈现控件后调用。 在派生的 adapter 类中，生成特定目标需要但 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 控件的开始标记。
RenderChildren(HtmlTextWriter)	为附加了控件适配器的复合控件中的子控件生成特定于目标的标记。 (继承自 ControlAdapter)
RenderContents(HtmlTextWriter)	为附加了控件适配器的 Web 控件生成特定于目标的内部标记内容。
RenderEndTag(HtmlTextWriter)	在传送到目标浏览器的标记内容中创建 Web 控件的结束标记。
SaveAdapterControlState()	保存控件适配器的控件状态信息。 (继承自 ControlAdapter)
SaveAdapterViewState()	保存控件适配器的视图状态信息。 (继承自 ControlAdapter)
ToString()	返回表示当前对象的字符串。 (继承自 Object)

另请参阅

• ControlAdapter
• WebControl
• Control