IExtenderControl 接口

定义

命名空间:

System.Web.UI

程序集:

System.Web.Extensions.dll

定义扩展程序控件的行为。

public interface class IExtenderControl

public interface IExtenderControl

type IExtenderControl = interface

Public Interface IExtenderControl

派生

System.Web.UI.ExtenderControl

注解

派生自类的扩展器控件 ExtenderControl 需要 ScriptManager 控件位于页面上。 ExtenderControl基类执行显式测试，以确保 ScriptManager 页面上存在控件。

但是，如果你想要创建扩展程序控件，并且该页不包含 ScriptManager 控件，则可以创建直接实现接口的类 IExtenderControl 。 此外，如果您要创建一个派生自的类， Control 或者您正在扩展派生自的现有控件 Control ，则可以实现该 IExtenderControl 接口以支持客户端功能。

IExtenderControl接口通过调用方法为控件注册脚本库 GetScriptReferences ，并 ScriptDescriptor 通过调用方法来注册对象 GetScriptDescriptors 。 GetScriptDescriptors方法返回 IEnumerable 对象的列表 ScriptDescriptor 。

备注

如果扩展派生自类的现有控件类型 WebControl ，请实现 IScriptControl 接口。

若要通过实现来创建扩展程序控件 IExtenderControl ，请执行以下操作：

• 为控件的事件编写代码， OnInit 以检测并使用 ScriptManager 控件（如果该控件在该页上可用）。

• 如果在 ScriptManager 页上不可用，则提供替代方法，通过调用类的静态方法来注册所需的脚本 ScriptManager 。

• 为成员提供受保护的虚拟成员 IExtenderControl 。

• 提供实例脚本作为向控件注册的脚本块 ScriptManager 。 必须在控件的 PreRender 、或事件期间执行此操作 PreRenderComplete Render 。

• 在控件事件期间注册脚本描述符 Render 。

备注

如果页面包含 UpdatePanel 控件，则页面必须包含 ScriptManager 控件。 IExtenderControl仅当页不包含控件时，才必须实现接口 ScriptManager 。

方法

GetScriptDescriptors(Control)	为控件注册 ScriptDescriptor 对象，并为该控件返回包含 ScriptDescriptor 对象的对象。
GetScriptReferences()	为控件注册脚本库，并返回已注册为嵌入资源的 ECMAScript (JavaScript) 文件的枚举。

另请参阅

• ExtenderControl
• ScriptManager