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

Los controles extensores que derivan ExtenderControl de la clase ScriptManager requieren un control en la página.Extender controls that derive from the ExtenderControl class require a ScriptManager control to be on the page. La ExtenderControl clase base realiza una prueba explícita para asegurarse de que existe ScriptManager un control 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 controles extensores y la página no contiene un ScriptManager control, puede crear una clase que implemente la 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 va a crear una clase que deriva de Control o va a extender un control existente que se deriva de, puede implementar la interfaz para admitir la IExtenderControl funcionalidad de Controlcliente.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.

La IExtenderControl interfaz registra las bibliotecas de scripts para un control llamando al GetScriptReferences método y registra ScriptDescriptor los objetos llamando al 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 una IEnumerable lista de ScriptDescriptor objetos.The GetScriptDescriptors method returns an IEnumerable list of ScriptDescriptor objects.

Nota

Si extiende un tipo de control existente que se deriva de la WebControl clase, implemente IScriptControl la 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:

  • Escriba código para el evento del OnInit control para detectar y usar el ScriptManager control 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 para registrar los scripts necesarios llamando 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 los miembros.Provide protected virtual members for IExtenderControl members.

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

  • Registre los descriptores de script durante el evento Render del control.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: