IExtenderControl Interfaz

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.Extensions.dll

Define el comportamiento de un control extensor.

public interface class IExtenderControl

public interface IExtenderControl

type IExtenderControl = interface

Public Interface IExtenderControl

Derivado

System.Web.UI.ExtenderControl

Comentarios

Los controles extensores que derivan de la ExtenderControl clase requieren un ScriptManager control en la página. La ExtenderControl clase base realiza una prueba explícita para asegurarse de que ScriptManager existe un control en la página.

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. Además, si va a crear una clase que deriva de Control o va a extender un control existente que se deriva de Control , puede implementar la IExtenderControl interfaz para admitir la funcionalidad de cliente.

La IExtenderControl interfaz registra las bibliotecas de scripts para un control llamando al GetScriptReferences método y registra los objetos llamando ScriptDescriptor al GetScriptDescriptors método. El GetScriptDescriptors método devuelve una IEnumerable lista de ScriptDescriptor objetos.

Nota

Si extiende un tipo de control existente que se deriva de la WebControl clase, implemente la IScriptControl interfaz.

Para crear un control extensor implementando IExtenderControl , realice lo siguiente:

• Escriba código para el evento del control OnInit para detectar y usar el ScriptManager control si está disponible en la página.

• 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.

• Proporcione miembros virtuales protegidos para IExtenderControl los miembros.

• Proporcione el script de instancia como un bloque de script que se registra con el ScriptManager control. Debe hacerlo durante los PreRender eventos, o del control PreRenderComplete Render .

• Registre los descriptores de script durante el evento del control Render .

Nota

Si la página contiene un UpdatePanel control, la página debe contener un ScriptManager control. Debe implementar la IExtenderControl interfaz solo cuando la página no contiene un ScriptManager control.

Métodos

GetScriptDescriptors(Control)	Registra los objetos ScriptDescriptor del control y devuelve un objeto que contiene los objetos ScriptDescriptor del control.
GetScriptReferences()	Registra las bibliotecas de scripts del control y devuelve una enumeración de los archivos ECMAScript (JavaScript) registrados como recursos incrustados.

Consulte también

• ExtenderControl
• ScriptManager