Partilhar via


IExtenderControl Interface

Definição

Define o comportamento de um controle do extensor.

public interface class IExtenderControl
public interface IExtenderControl
type IExtenderControl = interface
Public Interface IExtenderControl
Derivado

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.

Aplica-se a

Confira também