Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.
Assembly: System.Web (in System.Web.dll)
Protected Friend Overridable Sub RenderChildren ( _
writer As [%$TOPIC/5ya0d8es_en-us_VS_110_2_0_0_0_0%] _
)protected internal virtual void RenderChildren(
[%$TOPIC/5ya0d8es_en-us_VS_110_2_0_1_0_0%] writer
)protected public:
virtual void RenderChildren(
[%$TOPIC/5ya0d8es_en-us_VS_110_2_0_2_0_0%]^ writer
)abstract RenderChildren :
writer:[%$TOPIC/5ya0d8es_en-us_VS_110_2_0_3_0_0%] -> unit
override RenderChildren :
writer:[%$TOPIC/5ya0d8es_en-us_VS_110_2_0_3_0_1%] -> unitParameters
- writer
- Type:
System.Web.UIHtmlTextWriter
The HtmlTextWriter object that receives the rendered content.
This method notifies ASP.NET to render any Active Server Pages (ASP) code on the page. If no ASP code exists on the page, this method renders any child controls for the server control. This method is called by the Render method.
The following example overrides the RenderChildren method in a custom server control. It determines whether the current control has any child controls in its ControlCollection object. If it does, it uses the Count property to iterate through the collection. As it encounters each child control, it uses the RenderControl method to render the parent control, and all of its child controls, to the containing page.
The overridden Render method then calls the overridden RenderChildren method.
' 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 'RenderChildren
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// 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);
}Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
