WebControlAdapter Classe

Referência

Definição

Namespace:: System.Web.UI.WebControls.Adapters

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Personaliza a renderização do controle da Web ao qual o adaptador de controle é anexado para modificar a marcação padrão ou o comportamento de navegadores específicos.

public ref class WebControlAdapter : System::Web::UI::Adapters::ControlAdapter

public class WebControlAdapter : System.Web.UI.Adapters.ControlAdapter

type WebControlAdapter = class
    inherit ControlAdapter

Public Class WebControlAdapter
Inherits ControlAdapter

Herança: Object

ControlAdapter
WebControlAdapter

Derivado: System.Web.UI.WebControls.Adapters.DataBoundControlAdapter

System.Web.UI.WebControls.Adapters.HideDisabledControlAdapter

System.Web.UI.WebControls.Adapters.HierarchicalDataBoundControlAdapter

System.Web.UI.WebControls.Adapters.MenuAdapter

Comentários

A WebControl classe é a classe base da qual os controles Web herdam. Ele define muitas propriedades comuns a todos os controles da Web. Para obter mais informações, consulte WebControl.

Um objeto é um componente que substitui determinadas classes ou métodos herdados e eventos em seu ciclo de vida de execução para permitir a manipulação específica WebControlAdapter do navegador ou da WebControl marcação. O .NET Framework mapeia um único adaptador de controle para um objeto WebControl derivado para cada solicitação do cliente.

Um adaptador modifica um comportamento de controle para um navegador específico ou classe de navegadores ou atua como um filtro arbitrário em alguma funcionalidade. Grande parte da capacidade de adaptação 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 classe do navegador ou que a inclusão da capacidade de adaptação nas classes possa tornar desnecessário o uso de um adaptador HtmlTextWriter de controle.

Os próprios controles não exigem necessariamente um adaptador. Se os controles são estendidos por meio da composição, geralmente os adaptadores para os controles filho são suficientes.

Cada controle tem mapeamentos explícitos para adaptadores por meio dos arquivos de definição do .browser. Portanto, qualquer acesso à propriedade de usa o objeto extraído dos arquivos de definição do .browser para executar a busca do mapeamento do Adapter WebControl adaptador a ser HttpBrowserCapabilities controlado.

Durante o processamento, o .NET Framework intercepta chamadas para os métodos que podem ser substituídos de um controle que pode ser específico do destino. Se um adaptador de controle estiver anexado, o .NET Framework chamará os métodos de adaptador associados. Para obter mais informações, consulte ControlAdapter.

A renderização de um normalmente consiste em uma marcação inicial e final e alguma marcação interna WebControl entre as marcas inicial e final. As marcas são definidas quando WebControl o é criado. Para obter mais informações, consulte WebControl.

As marcas são geradas pelos RenderBeginTag métodos RenderEndTag e , respectivamente. A marcação interna é gerada pelo RenderContents método .

O Render método gera toda a marcação chamando métodos na seguinte ordem:

A IsEnabled propriedade true retornará somente se o e todos os WebControl seus controles pai estão habilitados. A Control propriedade retorna uma referência fortemente digitada para o WebControl .

Construtores

WebControlAdapter()

Inicializa uma nova instância da classe WebControlAdapter.

Propriedades

Browser	Obtém uma referência aos recursos do navegador do cliente que está fazendo a solicitação HTTP atual. (Herdado de ControlAdapter)
Control	Obtém uma referência ao controle da Web ao qual esse adaptador de controle está anexado.
IsEnabled	Obtém um valor que indica se o controle da Web e todos os seus controles pais estão habilitados.
Page	Obtém uma referência à página em que o controle associado a esse adaptador está. (Herdado de ControlAdapter)
PageAdapter	Obtém uma referência ao adaptador de página da página em que o controle associado está. (Herdado de ControlAdapter)

Métodos

BeginRender(HtmlTextWriter)	Chamado antes da renderização de um controle. Em uma classe de adaptador derivada, gera marcas de abertura que são necessárias para um destino específico, mas não para navegadores HTML. (Herdado de ControlAdapter)
CreateChildControls()	Cria os controles filho de destino específico de um controle de composição. (Herdado de ControlAdapter)
EndRender(HtmlTextWriter)	Chamado depois da renderização de um controle. Em uma classe de adaptador derivada, gera marcas de fechamento que são necessárias para um destino específico, mas não para navegadores HTML. (Herdado de ControlAdapter)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadAdapterControlState(Object)	Carrega informações sobre o estado do controle do adaptador que foram salvas pelo SaveAdapterControlState() durante a solicitação anterior à página em que o controle associado a esse adaptador de controle está. (Herdado de ControlAdapter)
LoadAdapterViewState(Object)	Carrega informações sobre o estado de exibição do adaptador que foram salvas pelo SaveAdapterViewState() durante uma solicitação anterior à página em que o controle associado a esse adaptador de controle está. (Herdado de ControlAdapter)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnInit(EventArgs)	Substitui o método OnInit(EventArgs) do controle associado. (Herdado de ControlAdapter)
OnLoad(EventArgs)	Substitui o método OnLoad(EventArgs) do controle associado. (Herdado de ControlAdapter)
OnPreRender(EventArgs)	Substitui o método OnPreRender(EventArgs) do controle associado. (Herdado de ControlAdapter)
OnUnload(EventArgs)	Substitui o método OnUnload(EventArgs) do controle associado. (Herdado de ControlAdapter)
Render(HtmlTextWriter)	Gera a marcação específica para o destino para o controle ao qual o adaptador de controle está anexado.
RenderBeginTag(HtmlTextWriter)	Cria a marca de início para o controle da Web na marcação que é transmitida para o navegador de destino.
RenderChildren(HtmlTextWriter)	Gera a marcação específica para o destino dos controles filho em um controle de composição ao qual o adaptador de controle está anexado. (Herdado de ControlAdapter)
RenderContents(HtmlTextWriter)	Gera a marcação interna específica do destino do controle da Web ao qual o adaptador de controle está anexado.
RenderEndTag(HtmlTextWriter)	Cria a marca de término para o controle da Web na marcação que é transmitida para o navegador de destino.
SaveAdapterControlState()	Salva informações de estado do controle do adaptador de controle. (Herdado de ControlAdapter)
SaveAdapterViewState()	Salva informações de estado de exibição do adaptador de controle. (Herdado de ControlAdapter)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a