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 in un oggetto fornito HtmlTextWriter , 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

Oggetto HtmlTextWriter che riceve il contenuto sottoposto a 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 affermativo, usa la Count proprietà per scorrere l'insieme. Quando rileva ogni controllo figlio, usa il RenderControl metodo per eseguire il rendering del controllo padre e di tutti i relativi controlli figlio nella pagina contenitore.

Il metodo sottoposto a Render override chiama quindi il metodo sottoposto RenderChildren a override.

// 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)