IExtenderControl 接口

定义

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

public interface class IExtenderControl
public interface IExtenderControl
type IExtenderControl = interface
Public Interface IExtenderControl
派生

注解

派生自类的 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 脚本块提供。 必须在控件或PreRenderPreRenderCompleteRender事件期间执行此操作。

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

注释

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

方法

名称 说明
GetScriptDescriptors(Control)

ScriptDescriptor注册控件的对象,并返回一个对象,该对象包含ScriptDescriptor控件的对象。

GetScriptReferences()

注册控件的脚本库,并返回已注册为嵌入式资源的 ECMAScript (JavaScript) 文件的枚举。

适用于

另请参阅