Control.RenderChildren(HtmlTextWriter) Método
Definição
Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.
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
O objeto HtmlTextWriter que recebe o conteúdo renderizado.The HtmlTextWriter object that receives the rendered content.
Exemplos
O exemplo a seguir substitui o RenderChildren método em um controle de servidor personalizado.The following example overrides the RenderChildren method in a custom server control. Ele determina se o controle atual tem quaisquer controles filho em seu ControlCollection objeto.It determines whether the current control has any child controls in its ControlCollection object. Se tiver, ele usará a Count propriedade para iterar pela coleção.If it does, it uses the Count property to iterate through the collection. Como ele encontra cada controle filho, ele usa o RenderControl método para renderizar o controle pai e todos os seus controles filho, para a página que a contém.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.
RenderEm seguida, o método substituído chama o RenderChildren método substituído.The overridden Render method then calls the overridden RenderChildren method.
// 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
Comentários
Esse método notifica o ASP.NET para renderizar qualquer código de páginas de Active Server (ASP) na página.This method notifies ASP.NET to render any Active Server Pages (ASP) code on the page. Se não existir nenhum código ASP na página, esse método renderizará todos os controles filho do controle de servidor.If no ASP code exists on the page, this method renders any child controls for the server control. Esse método é chamado pelo Render método.This method is called by the Render method.