HideDisabledControlAdapter.Render(HtmlTextWriter) Método

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.

Grava o controle da Web associado ao fluxo de saída como HTML.

protected public:
 override void Render(System::Web::UI::HtmlTextWriter ^ writer);

protected internal override void Render (System.Web.UI.HtmlTextWriter writer);

override this.Render : System.Web.UI.HtmlTextWriter -> unit

Protected Friend Overrides Sub Render (writer As HtmlTextWriter)

Parâmetros

writer: HtmlTextWriter

O HtmlTextWriter que contém métodos para compilar e renderizar a saída específica ao dispositivo.

Exemplos

O exemplo de código a seguir demonstra como substituir o Render método para passar o HtmlTextWriter objeto para o controle pai para renderização se o controle associado estiver habilitado. Este exemplo de código faz parte de um exemplo maior fornecido para a HideDisabledControlAdapter classe.

protected override void Render(System.Web.UI.HtmlTextWriter writer)
{
    if (Control.ID.StartsWith("Contoso"))
    {
        if (!Control.Enabled)
        {
            return;
        }
    }

    base.Render(writer);
}

Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)
    If (Control.ID.StartsWith("Contoso")) Then
        If (Not Control.Enabled) Then
            Return
        End If
    End If

    MyBase.Render(writer)
End Sub

Comentários

O Render método grava o controle associado WebControl no fluxo de saída como HTML.

Por padrão, o .NET Framework chamadas no próprio Render método do controle do servidor Web. No entanto, depois que a Adapter propriedade desse controle for definida, a .NET Framework executará a implementação do adaptador do evento sobre a Render do controle associado.

O Render evento é usado para executar modificações no código de marcação renderizado em um navegador do dispositivo. As propriedades de controle devem ser definidas antes dessa fase do ciclo de vida e apenas a criação de marcação real para o controle feito aqui. As alterações feitas no controle nesta fase do ciclo de vida não são salvas para exibir o estado. Para salvar as alterações feitas no controle, substitua o OnPreRender evento.

O Render evento também permite que classes derivadas manipulem o evento sem anexar um delegado, que é a técnica preferencial para lidar com o evento em uma classe derivada.

Aplica-se a

Compartilhar via