Control.RenderChildren(HtmlTextWriter) Metodo

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto HtmlTextWriter specificato, che scrive il contenuto di cui eseguire il rendering nel client.

protected public:
 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 Friend Overridable Sub RenderChildren (writer As HtmlTextWriter)

Parametri

writer

HtmlTextWriter

L'oggetto HtmlTextWriter che riceve il contenuto di cui è stato eseguito il rendering.

Esempio

Nell'esempio seguente viene eseguito l'override del RenderChildren metodo in un controllo server personalizzato. Determina se il controllo corrente dispone di controlli figlio nel relativo ControlCollection oggetto. In caso contrario, usa la Count proprietà per scorrere la raccolta. Quando rileva ogni controllo figlio, usa il metodo per eseguire il RenderControl rendering del controllo padre e tutti i relativi controlli figlio alla pagina contenente.

Il metodo sottoposto a override Render chiama quindi il metodo sottoposto a override 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

Commenti

Questo metodo notifica ASP.NET di eseguire il rendering di qualsiasi codice ASP (Active Server Pages) nella pagina. Se nella pagina non esiste alcun codice ASP, questo metodo esegue il rendering di tutti i controlli figlio per il controllo server. Questo metodo viene chiamato dal Render metodo .

Vedi anche

• Render(HtmlTextWriter)
• RenderControl(HtmlTextWriter)