IExtenderControl 接口
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
定义扩展程序控件的行为。
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) 文件的枚举。 |