IExtenderControl Interfaccia

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Definisce il comportamento di un controllo estensione.

public interface class IExtenderControl

public interface IExtenderControl

type IExtenderControl = interface

Public Interface IExtenderControl

Derivato

System.Web.UI.ExtenderControl

Commenti

I controlli Extender che derivano dalla ExtenderControl classe richiedono che un ScriptManager controllo sia presente nella pagina. La ExtenderControl classe base esegue un test esplicito per assicurarsi che un ScriptManager controllo esista nella pagina.

Tuttavia, se si desidera creare controlli Extender e la pagina non contiene un ScriptManager controllo, è possibile creare una classe che implementi direttamente l' IExtenderControl interfaccia. Inoltre, se si sta creando una classe che deriva da Control o si sta estendendo un controllo esistente che deriva da Control , è possibile implementare l' IExtenderControl interfaccia per supportare la funzionalità client.

L' IExtenderControl interfaccia registra le librerie di script per un controllo chiamando il GetScriptReferences metodo e registra ScriptDescriptor gli oggetti chiamando il GetScriptDescriptors metodo. Il GetScriptDescriptors metodo restituisce un IEnumerable elenco di ScriptDescriptor oggetti.

Nota

Se si estende un tipo di controllo esistente derivato dalla WebControl classe, implementare l' IScriptControl interfaccia.

Per creare un controllo Extender mediante l'implementazione di IExtenderControl , eseguire le operazioni seguenti:

• Scrivere il codice per l'evento del controllo OnInit per rilevare e usare il ScriptManager controllo se è disponibile nella pagina.

• Se ScriptManager non è disponibile nella pagina, fornire un metodo alternativo per registrare gli script necessari chiamando metodi statici della ScriptManager classe.

• Fornire membri virtuali protetti per IExtenderControl i membri.

• Specificare lo script di istanza come blocco di script da registrare con il ScriptManager controllo. Questa operazione deve essere eseguita durante gli PreRender eventi, PreRenderComplete o del controllo Render .

• Registrare i descrittori di script durante l'evento del controllo Render .

Nota

Se la pagina contiene un UpdatePanel controllo, la pagina deve contenere un ScriptManager controllo. È necessario implementare l' IExtenderControl interfaccia solo quando la pagina non contiene un ScriptManager controllo.

Metodi

GetScriptDescriptors(Control)	Registra gli oggetti ScriptDescriptor relativi al controllo e restituisce un oggetto che contiene gli oggetti ScriptDescriptor relativi al controllo.
GetScriptReferences()	Registra le librerie di script per il controllo e restituisce un'enumerazione dei file ECMAScript (JavaScript) registrati come risorse incorporate.

Vedi anche

• ExtenderControl
• ScriptManager