Control.Render(HtmlTextWriter) Método

Referencia

Definición

Espacio de nombres:: System.Web.UI

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Envía el contenido del control de servidor al objeto HtmlTextWriter proporcionado, que escribe el contenido que se representará en el 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

Objeto HtmlTextWriter que recibe el contenido del control de servidor.

Ejemplos

En el ejemplo de código siguiente se muestra la invalidación del Render método . El HasControls método se usa para determinar si el control de servidor tiene algún control secundario almacenado en su ControlCollection objeto, al que se puede acceder a través de la Control.Controls propiedad . Si HasControls devuelve true y el primer control de servidor de la colección es texto literal, el texto literal se anexa a una cadena 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

Comentarios

Al desarrollar controles de servidor personalizados, puede invalidar este método para generar contenido para una página de ASP.NET.

Se aplica a

Producto	Versiones
.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

Compartir a través de