IExtenderControl Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Define el comportamiento de un control extensor.
public interface class IExtenderControlpublic interface IExtenderControltype IExtenderControl = interfacePublic Interface IExtenderControl- Derivado
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
OnInitpara 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
PreRendereventos, o del controlPreRenderCompleteRender.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. |