WebControlAdapter Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Personaliza a renderização para o controlo Web ao qual o adaptador de controlo está ligado, para modificar a marcação ou comportamento padrão para navegadores específicos.
public ref class WebControlAdapter : System::Web::UI::Adapters::ControlAdapterpublic class WebControlAdapter : System.Web.UI.Adapters.ControlAdaptertype WebControlAdapter = class
inherit ControlAdapterPublic Class WebControlAdapter
Inherits ControlAdapter- Herança
- Derivado
Observações
A WebControl classe é a classe base da qual os controlos Web herdam. Define muitas propriedades comuns a todos os controlos Web. Para obter mais informações, veja WebControl.
Um WebControlAdapter objeto é um componente que substitui certos WebControl métodos e eventos de classe ou herdados no seu ciclo de vida de execução para permitir o tratamento específico do navegador ou da marcação. .NET Framework mapeia um único adaptador de controlo para um objeto derivado WebControl para cada pedido do cliente.
Um adaptador modifica um comportamento de controlo para um navegador específico ou classe de navegadores ou atua como um filtro arbitrário numa funcionalidade. Grande parte da adaptabilidade no comportamento de renderização pode ser encapsulada nas classes especializadas que derivam da HtmlTextWriter classe. Portanto, é provável que um único adaptador possa ser usado para vários comportamentos de classes de navegador ou que a inclusão da adaptabilidade nas HtmlTextWriter classes torne desnecessária a utilização de um adaptador de controlo.
Os próprios controlos não requerem necessariamente um adaptador. Se os controlos forem estendidos através da composição, geralmente os adaptadores para os controlos filhos são suficientes.
Cada controlo tem mapeamentos explícitos para adaptadores através dos ficheiros de definição .browser. Assim, qualquer acesso à Adapter propriedade de WebControl utiliza o HttpBrowserCapabilities objeto extraído dos ficheiros de definição .browser para realizar a pesquisa do mapeamento do adaptador para controlo.
Durante o processamento, o .NET Framework interceta chamadas para os métodos sobrescritivos de um controlo que podem ser específicos do alvo. Se um adaptador de controlo estiver ligado, o .NET Framework chama os métodos do adaptador associados. Para obter mais informações, veja ControlAdapter.
A renderização para um WebControl consiste tipicamente numa etiqueta de início e de fim, e alguma marcação interna entre as etiquetas de início e fim. As etiquetas são definidas quando o WebControl é criado. Para obter mais informações, veja WebControl.
As etiquetas são geradas pelos RenderBeginTag métodos e RenderEndTag , respetivamente. A marcação interna é gerada pelo RenderContents método.
O Render método gera toda a marcação, chamando métodos pela seguinte ordem:
A IsEnabled propriedade retorna true apenas se e WebControl todos os seus controlos pais estiverem ativados. A Control propriedade devolve uma referência fortemente tipada ao WebControl.
Construtores
| Name | Description |
|---|---|
| WebControlAdapter() |
Inicializa uma nova instância da WebControlAdapter classe. |
Propriedades
| Name | Description |
|---|---|
| Browser |
Obtém uma referência às capacidades do navegador do cliente que faz o pedido HTTP atual. (Herdado de ControlAdapter) |
| Control |
Obtém uma referência ao controlo Web ao qual este adaptador de controlo está ligado. |
| IsEnabled |
Recebe um valor que indica se o controlo Web e todos os seus controlos pais estão ativados. |
| Page |
Recebe uma referência para a página onde está o controlo associado a este adaptador. (Herdado de ControlAdapter) |
| PageAdapter |
Obtém uma referência ao adaptador de página da página onde reside o controlo associado. (Herdado de ControlAdapter) |
Métodos
| Name | Description |
|---|---|
| BeginRender(HtmlTextWriter) |
Chamado antes da renderização de um controlo. Numa classe adaptadora derivada, gera etiquetas de abertura que são exigidas por um destino específico mas não necessárias pelos navegadores HTML. (Herdado de ControlAdapter) |
| CreateChildControls() |
Cria os controlos filhos específicos do alvo para um controlo composto. (Herdado de ControlAdapter) |
| EndRender(HtmlTextWriter) |
Chamado após a renderização de um controlo. Numa classe adaptadora derivada, gera etiquetas de fecho que são exigidas por um destino específico mas não necessárias pelos navegadores HTML. (Herdado de ControlAdapter) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| LoadAdapterControlState(Object) |
Carrega a informação do estado de controlo do adaptador que foi guardada SaveAdapterControlState() durante um pedido anterior na página onde reside o controlo associado a este adaptador. (Herdado de ControlAdapter) |
| LoadAdapterViewState(Object) |
O adaptador carrega a informação de estado da visualização que foi guardada durante SaveAdapterViewState() um pedido anterior para a página onde reside o controlo associado a este adaptador de controlo. (Herdado de ControlAdapter) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnInit(EventArgs) |
Sobrepõe o OnInit(EventArgs) método para o controlo associado. (Herdado de ControlAdapter) |
| OnLoad(EventArgs) |
Sobrepõe o OnLoad(EventArgs) método para o controlo associado. (Herdado de ControlAdapter) |
| OnPreRender(EventArgs) |
Sobrepõe o OnPreRender(EventArgs) método para o controlo associado. (Herdado de ControlAdapter) |
| OnUnload(EventArgs) |
Sobrepõe o OnUnload(EventArgs) método para o controlo associado. (Herdado de ControlAdapter) |
| Render(HtmlTextWriter) |
Gera a marcação específica do alvo para o controlo ao qual o adaptador de controlo está ligado. |
| RenderBeginTag(HtmlTextWriter) |
Cria a etiqueta inicial para o controlo Web na marcação que é transmitida para o navegador de destino. |
| RenderChildren(HtmlTextWriter) |
Gera a marcação específica do alvo para os controlos filhos num controlo composto ao qual o adaptador de controlo está ligado. (Herdado de ControlAdapter) |
| RenderContents(HtmlTextWriter) |
Gera a marcação interna específica do alvo para o controlo Web ao qual o adaptador de controlo está ligado. |
| RenderEndTag(HtmlTextWriter) |
Cria a etiqueta final para o controlo Web na marcação que é transmitida ao navegador de destino. |
| SaveAdapterControlState() |
Guarda a informação do estado de controlo para o adaptador de controlo. (Herdado de ControlAdapter) |
| SaveAdapterViewState() |
Guarda a informação do estado da vista para o adaptador de controlo. (Herdado de ControlAdapter) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |