IExtenderControl IExtenderControl IExtenderControl IExtenderControl Interface

Definición

Define el comportamiento de un control extensor.Defines the behavior for an extender control.

public interface class IExtenderControl
public interface IExtenderControl
type IExtenderControl = interface
Public Interface IExtenderControl
Derivado

Comentarios

Controles del extensor que se derivan de la ExtenderControl clase requieren un ScriptManager control en la página.Extender controls that derive from the ExtenderControl class require a ScriptManager control to be on the page. El ExtenderControl clase base realiza una prueba explícita para asegurarse de que un ScriptManager control existe en la página.The ExtenderControl base class performs an explicit test to make sure that a ScriptManager control exists on the page.

Sin embargo, si desea crear los controles del extensor y la página no contiene un ScriptManager control, puede crear una clase que implementa el IExtenderControl interfaz directamente.However, if you want to create extender controls and the page does not contain an ScriptManager control, you can create a class that implements the IExtenderControl interface directly. Además, si está creando una clase que derive de Control o amplía un control existente que se deriva de Control, puede implementar el IExtenderControl interfaz para admitir la funcionalidad de cliente.Additionally, if you are creating a class that derives from Control or you are extending an existing control that derives from Control, you can implement the IExtenderControl interface to support client functionality.

El IExtenderControl interfaz registra las bibliotecas de scripts para un control mediante una llamada a la GetScriptReferences método y se registra ScriptDescriptor objetos mediante una llamada a la GetScriptDescriptors método.The IExtenderControl interface registers the script libraries for a control by calling the GetScriptReferences method, and it registers ScriptDescriptor objects by calling the GetScriptDescriptors method. El GetScriptDescriptors método devuelve un IEnumerable lista de ScriptDescriptor objetos.The GetScriptDescriptors method returns an IEnumerable list of ScriptDescriptor objects.

Nota

Si extender un tipo de control existente que se deriva el WebControl clase, implemente el IScriptControl interfaz.If you extend an existing control type that is derived from the WebControl class, implement the IScriptControl interface.

Para crear un control extensor implementando IExtenderControl, realice lo siguiente:To create an extender control by implementing IExtenderControl, you do the following:

  • Escribir código para el control OnInit eventos para detectar y usar el ScriptManager controlar si está disponible en la página.Write code for the control's OnInit event to detect and use the ScriptManager control if it is available on the page.

  • Si el ScriptManager no está disponible en la página, proporcione medios alternativos registrar los scripts necesarios mediante una llamada a métodos estáticos de la ScriptManager clase.If the ScriptManager is not available on the page, provide alternative means to register required scripts by calling static methods of the ScriptManager class.

  • Proporcione miembros virtuales protegidos para IExtenderControl miembros.Provide protected virtual members for IExtenderControl members.

  • Proporcionar el script de la instancia como un bloque de script que se registra con el ScriptManager control.Provide instance script as a script block that you register with the ScriptManager control. Debe hacerlo durante el control PreRender, PreRenderComplete, o Render eventos.You must do this during the control's PreRender, PreRenderComplete, or Render events.

  • Registrar los descriptores de script durante el control Render eventos.Register the script descriptors during the control's Render event.

Nota

Si la página contiene un UpdatePanel (control), la página debe contener un ScriptManager control.If the page contains an UpdatePanel control, the page must contain a ScriptManager control. Debe implementar la IExtenderControl interfaz solo cuando la página no contiene un ScriptManager control.You must implement the IExtenderControl interface only when the page does not contain a ScriptManager control.

Métodos

GetScriptDescriptors(Control) GetScriptDescriptors(Control) GetScriptDescriptors(Control) GetScriptDescriptors(Control)

Registra los objetos ScriptDescriptor del control y devuelve un objeto que contiene los objetos ScriptDescriptor del control.Registers the ScriptDescriptor objects for the control and returns an object that contains the ScriptDescriptor objects for the control.

GetScriptReferences() GetScriptReferences() GetScriptReferences() GetScriptReferences()

Registra las bibliotecas de scripts del control y devuelve una enumeración de los archivos ECMAScript (JavaScript) registrados como recursos incrustados.Registers the script libraries for the control and returns an enumeration of ECMAScript (JavaScript) files that have been registered as embedded resources.

Se aplica a

Consulte también: