HideDisabledControlAdapter.Render(HtmlTextWriter) Método
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.
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.