IExtenderControl Interface

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Define o comportamento de um controle do extensor.

public interface class IExtenderControl

public interface IExtenderControl

type IExtenderControl = interface

Public Interface IExtenderControl

Derivado

System.Web.UI.ExtenderControl

Comentários

Os controles do extensor que derivam da ExtenderControl classe exigem ScriptManager que um controle esteja na página. A ExtenderControl classe base executa um teste explícito para garantir que ScriptManager exista um controle na página.

No entanto, se você quiser criar controles de extensor e a página não contiver um ScriptManager controle, você poderá criar uma classe que implementa a IExtenderControl interface diretamente. Além disso, se você estiver criando uma classe que deriva de Control ou estiver estendendo um controle existente que deriva de Control , você pode implementar a IExtenderControl interface para dar suporte à funcionalidade do cliente.

A IExtenderControl interface registra as bibliotecas de script para um controle chamando o GetScriptReferences método e registra os ScriptDescriptor objetos chamando o GetScriptDescriptors método. O GetScriptDescriptors método retorna uma IEnumerable lista de ScriptDescriptor objetos.

Observação

Se você estender um tipo de controle existente que é derivado da WebControl classe, implemente a IScriptControl interface.

Para criar um controle de extensor implementando IExtenderControl , faça o seguinte:

• Escreva o código para o evento do controle OnInit para detectar e usar o ScriptManager controle se ele estiver disponível na página.

• Se o ScriptManager não estiver disponível na página, forneça meios alternativos para registrar os scripts necessários chamando métodos estáticos da ScriptManager classe.

• Forneça Membros virtuais protegidos para IExtenderControl Membros.

• Forneça o script de instância como um bloco de script que você registra com o ScriptManager controle. Você deve fazer isso durante os PreRender eventos, ou, do controle PreRenderComplete Render .

• Registre os descritores de script durante o evento do controle Render .

Observação

Se a página contiver um UpdatePanel controle, a página deverá conter um ScriptManager controle. Você deve implementar a IExtenderControl interface somente quando a página não contiver um ScriptManager controle.

Métodos

GetScriptDescriptors(Control)	Registra os objetos ScriptDescriptor para o controle e retorna um objeto que contém os objetos ScriptDescriptor para o controle.
GetScriptReferences()	Registra as bibliotecas de scripts para o controle e retorna uma enumeração de arquivos de ECMAScript (JavaScript) que foram registrados como recursos inseridos.

Confira também

• ExtenderControl
• ScriptManager