Control.RenderChildren(HtmlTextWriter) Método

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

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

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);
}

' 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 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