Control.RenderChildren(HtmlTextWriter) Método

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve 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 HtmlTextWriter objeto que recebe o conteúdo renderizado.

Exemplos

O exemplo seguinte sobrepõe o RenderChildren método num controlo personalizado de servidor. Determina se o controlo atual tem algum controlo filho no seu ControlCollection objeto. Se o fizer, usa a Count propriedade para iterar pela coleção. À medida que encontra cada controlo filho, usa o RenderControl método para renderizar o controlo pai, e todos os seus controlos filhos, na página que contém.

O método sobreposto Render chama então o método sobreposto 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

Observações

Este método notifica o ASP.NET para renderizar qualquer código Active Server Pages (ASP) na página. Se não existir código ASP na página, este método renderiza quaisquer controlos filhos para o controlo do servidor. Este método é chamado pelo Render método.

Aplica-se a

Ver também