HideDisabledControlAdapter.Render(HtmlTextWriter) Método

Definição

Escreve o controlo Web associado no 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

Os HtmlTextWriter métodos de contenção para construir e renderizar a saída específica do dispositivo.

Exemplos

O exemplo de código seguinte demonstra como sobrescrever o Render método para passar o HtmlTextWriter objeto ao controlo pai para renderização, caso o controlo associado esteja ativado. 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

Observações

O Render método escreve o controlo associado WebControl ao fluxo de saída como HTML.

Por defeito, o .NET Framework recorre ao método Render do próprio controlo do servidor Web. No entanto, uma vez definida a propriedade Adapter desse controlo, o .NET Framework executará a implementação do evento Render pelo adaptador em vez do controlo associado.

O Render evento é usado para realizar modificações ao código de marcação que é renderizado para um navegador de dispositivos. As propriedades de controlo devem ser definidas antes desta fase do ciclo de vida e apenas a criação real da marcação para o controlo deve ser feita aqui. As alterações feitas ao controlo nesta fase do ciclo de vida não são guardadas para ver o estado. Para guardar alterações feitas ao controlo, anule o OnPreRender evento.

O Render evento também permite que classes derivadas tratem do evento sem anexar um delegado, que é a técnica preferida para gerir o evento numa classe derivada.

Aplica-se a

Ver também