IExtenderControl Interface

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.Extensions.dll

Define o comportamento de um controlo extensor.

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

Observações

Os controlos de extensor que derivam da ExtenderControl classe exigem que um ScriptManager controlo esteja na página. A ExtenderControl classe base realiza um teste explícito para garantir que existe um ScriptManager controlo na página.

No entanto, se quiseres criar controlos de extensor e a página não tiver controlo ScriptManager , podes criar uma classe que implemente diretamente a IExtenderControl interface. Além disso, se estiver a criar uma classe que deriva de Control ou estiver a estender um controlo existente que deriva de Control, pode implementar a IExtenderControl interface para suportar funcionalidades do cliente.

A IExtenderControl interface regista as bibliotecas de scripts de um controlo chamando o GetScriptReferences método, e regista ScriptDescriptor objetos chamando o GetScriptDescriptors método. O GetScriptDescriptors método devolve uma IEnumerable lista de ScriptDescriptor objetos.

Note

Se estenderes um tipo de controlo existente derivado da WebControl classe, implementa a IScriptControl interface.

Para criar um controlo de extensor implementando IExtenderControl, faz-se o seguinte:

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

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

  • Disponibilizar membros virtuais protegidos para IExtenderControl os membros.

  • Fornece o script de instância como um bloco de script que registas no ScriptManager controlo. Deve fazer isto durante os controlos PreRender, PreRenderComplete, ou Render eventos.

  • Registar os descritores do script durante o evento do Render controlo.

Note

Se a página contém um UpdatePanel controlo, a página deve conter um ScriptManager controlo. Deve implementar a IExtenderControl interface apenas quando a página não contiver um ScriptManager controlo.

Métodos

Name Description
GetScriptDescriptors(Control)

Regista os ScriptDescriptor objetos do controlo e devolve um objeto que contém os ScriptDescriptor objetos do controlo.
GetScriptReferences()

Regista as bibliotecas de scripts para o controlo e devolve uma enumeração de ficheiros ECMAScript (JavaScript) que foram registados como recursos incorporados.

Aplica-se a

Ver também