Ler em inglês

Compartilhar via


Control.Render(HtmlTextWriter) Método

Definição

Envia o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.

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

Parâmetros

writer
HtmlTextWriter

O objeto HtmlTextWriter que recebe o conteúdo do controle do servidor.

Exemplos

O exemplo de código a seguir demonstra a substituição do Render método . O HasControls método é usado para determinar se o controle do servidor tem controles filho armazenados em seu ControlCollection objeto, que é acessível por meio da Control.Controls propriedade . Se HasControls retornar true e o primeiro controle de servidor na coleção for texto literal, o texto literal será acrescentado a uma cadeia de caracteres HTML.

[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void Render(HtmlTextWriter output) {
    if ( (HasControls()) && (Controls[0] is LiteralControl) ) {
        output.Write("<H2>Your Message: " + ((LiteralControl) Controls[0]).Text + "</H2>");
    }
}

Comentários

Ao desenvolver controles de servidor personalizados, você pode substituir esse método para gerar conteúdo para uma página ASP.NET.

Aplica-se a

Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também