Control.Render(HtmlTextWriter) Método

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

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 public:
 virtual void Render(System::Web::UI::HtmlTextWriter ^ writer);
protected virtual void Render (System.Web.UI.HtmlTextWriter writer);
protected internal virtual void Render (System.Web.UI.HtmlTextWriter writer);
abstract member Render : System.Web.UI.HtmlTextWriter -> unit
override this.Render : System.Web.UI.HtmlTextWriter -> unit
Protected Overridable Sub Render (writer As HtmlTextWriter)
Protected Friend Overridable Sub Render (writer As HtmlTextWriter)

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>");
    }
}

<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub Render(Output As HtmlTextWriter)
    If HasControls() And TypeOf Controls(0) Is LiteralControl
        Dim Ctrl As LiteralControl = CType(Controls(0), LiteralControl)
        Output.Write("<H2>Your Message: " & Ctrl.Text & "</H2>")
    End If
End Sub

Comentários

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

Aplica-se a

Confira também