Ler em inglês

Compartilhar via


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.

protected virtual void RenderChildren(System.Web.UI.HtmlTextWriter writer);
protected internal virtual void RenderChildren(System.Web.UI.HtmlTextWriter writer);

Parâmetros

writer
HtmlTextWriter

O objeto HtmlTextWriter que recebe o conteúdo renderizado.

Exemplos

O exemplo a seguir substitui o RenderChildren método em um controle de servidor personalizado. Ele determina se o controle atual tem controles filho em seu ControlCollection objeto. Se isso acontecer, ele usará a Count propriedade para iterar por meio da coleção. À medida que 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 contém.

Em seguida, o método substituído Render chama o método substituído 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);
}

Comentários

Esse método notifica ASP.NET para renderizar qualquer código ASP (Active Server Pages) na página. Se nenhum código ASP existir na página, esse método renderizará todos os controles filho para o controle do servidor. Esse método é chamado pelo Render método .

Aplica-se a

Confira também