IExtenderControl Interface

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.Extensions.dll

Define o comportamento de um controle de extensor.

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

Comentários

Os controles de extensor que derivam da ExtenderControl classe exigem que um ScriptManager controle esteja na página. A ExtenderControl classe base executa um teste explícito para garantir que exista um ScriptManager 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 implemente a IExtenderControl interface diretamente. Além disso, se você estiver criando uma classe que deriva Control ou se estiver estendendo um controle existente do Controlqual deriva, você poderá 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 ScriptDescriptor objetos chamando o GetScriptDescriptors método. O GetScriptDescriptors método retorna uma IEnumerable lista de ScriptDescriptor objetos.

Note

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

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

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

  • Se não ScriptManager estiver disponível na página, forneça meios alternativos para registrar 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 o controle PreRenderPreRenderCompleteou Render eventos.

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

Note

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

Nome Description
GetScriptDescriptors(Control)

Registra os ScriptDescriptor objetos para o controle e retorna um objeto que contém os ScriptDescriptor objetos para o controle.
GetScriptReferences()

Registra as bibliotecas de script para o controle e retorna uma enumeração de arquivos ECMAScript (JavaScript) que foram registrados como recursos inseridos.

Aplica-se a

Confira também