Control.RenderChildren(HtmlTextWriter) Método
Definición
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 de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente.
protected:
virtual void RenderChildren(System::Web::UI::HtmlTextWriter ^ writer);
protected public:
virtual void RenderChildren(System::Web::UI::HtmlTextWriter ^ writer);
protected virtual void RenderChildren (System.Web.UI.HtmlTextWriter writer);
protected internal virtual void RenderChildren (System.Web.UI.HtmlTextWriter writer);
abstract member RenderChildren : System.Web.UI.HtmlTextWriter -> unit
override this.RenderChildren : System.Web.UI.HtmlTextWriter -> unit
Protected Overridable Sub RenderChildren (writer As HtmlTextWriter)
Protected Friend Overridable Sub RenderChildren (writer As HtmlTextWriter)
Parámetros
- writer
- HtmlTextWriter
El objeto HtmlTextWriter que recibe el contenido representado.
Ejemplos
En el ejemplo siguiente se reemplaza el RenderChildren método en un control de servidor personalizado. Determina si el control actual tiene controles secundarios en su ControlCollection objeto . Si lo hace, usa la Count propiedad para recorrer en iteración la colección. A medida que encuentra cada control secundario, usa el RenderControl método para representar el control primario, y todos sus controles secundarios, en la página contenedora.
A continuación, el método invalidado Render llama al método invalidado RenderChildren .
// Override default implementation to Render children according to needs.
protected override void RenderChildren(HtmlTextWriter output)
{
if (HasControls())
{
// Render Children in reverse order.
for(int i = Controls.Count - 1; i >= 0; --i)
{
Controls[i].RenderControl(output);
}
}
}
protected override void Render(HtmlTextWriter output)
{
output.Write("<br>Message from Control : " + Message);
output.Write("Showing Custom controls created in reverse" +
"order");
// Render Controls.
RenderChildren(output);
}
' Override default implementation to Render children according to needs.
Protected Overrides Sub RenderChildren(output As HtmlTextWriter)
If HasControls() Then
' Render Children in reverse order.
Dim i As Integer
For i = Controls.Count - 1 To 0 Step -1
Controls(i).RenderControl(output)
Next
End If
End Sub
Protected Overrides Sub Render(output As HtmlTextWriter)
output.Write(("<br>Message from Control : " + Message))
output.Write(("Showing Custom controls created in reverse" + "order"))
' Render Controls.
RenderChildren(output)
End Sub
End Class
Comentarios
Este método notifica ASP.NET para representar cualquier código de Páginas active Server (ASP) en la página. Si no existe ningún código ASP en la página, este método representa los controles secundarios para el control de servidor. El método llama a Render este método.