Metodo Control.RenderChildren (System.Web.UI)

Cambia visualizzazione:

ScriptFree

Riferimento a .NET Framework

Metodo Control.RenderChildren

Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Invia il contenuto di un controllo figlio del controllo server a un oggetto HtmlTextWriter fornito, che scrive il contenuto di cui verrà effettuato il rendering sul client.

Spazio dei nomi: System.Web.UI
Assembly: System.Web (in System.Web.dll)

Sintassi

Visual Basic

Protected Friend Overridable Sub RenderChildren ( _
	writer As HtmlTextWriter _
)

protected internal virtual void RenderChildren(
	HtmlTextWriter writer
)

Visual C++

protected public:
virtual void RenderChildren(
	HtmlTextWriter^ writer
)

abstract RenderChildren : 
        writer:HtmlTextWriter -> unit 
override RenderChildren : 
        writer:HtmlTextWriter -> unit

Parametri

writer: Tipo: System.Web.UI.HtmlTextWriter
Oggetto HtmlTextWriter che riceve il contenuto di cui è stato effettuato il rendering.

Note

Questo metodo notifica ad ASP.NET di effettuare il rendering di qualsiasi codice Active Server Pages (ASP) sulla pagina. Se nella pagina non è presente codice ASP, questo metodo esegue il rendering di eventuali controlli figlio del controllo server. Questo metodo è chiamato dal metodo Render.

Esempi

Nell'esempio riportato di seguito il metodo RenderChildren in un controllo server personalizzato viene sottoposto a override. In tal modo si determina se il controllo corrente dispone di controlli figlio nel relativo oggetto ControlCollection. In caso affermativo, viene utilizzata la proprietà Count per far scorrere l'insieme. Ogni volta che viene rilevato un controllo figlio, viene utilizzato il metodo RenderControl per eseguire il rendering del controllo padre e di tutti i relativi controlli figlio nella pagina contenitore.

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

Visual Basic


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


      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


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

Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Vedere anche

Riferimenti

Control Classe

Spazio dei nomi System.Web.UI

Render

RenderControl