Control.RenderChildren(HtmlTextWriter) Metodo

Definizione

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.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

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)

Parametri

writer
HtmlTextWriter

L'oggetto HtmlTextWriter che riceve il contenuto di cui è stato eseguito il rendering.The HtmlTextWriter object that receives the rendered content.

Esempio

Nell'esempio seguente viene eseguito l'override del RenderChildren metodo in un controllo server personalizzato.The following example overrides the RenderChildren method in a custom server control. Determina se il controllo corrente dispone di controlli figlio nell' ControlCollection oggetto.It determines whether the current control has any child controls in its ControlCollection object. In caso affermativo, usa la Count proprietà per scorrere l'insieme.If it does, it uses the Count property to iterate through the collection. Quando incontra ogni controllo figlio, usa il RenderControl metodo per eseguire il rendering del controllo padre e di tutti i relativi controlli figlio nella pagina che lo contiene.As it encounters each child control, it uses the RenderControl method to render the parent control, and all of its child controls, to the containing page.

Il metodo sottoposto a override Render chiama quindi il metodo sottoposto a override RenderChildren .The overridden Render method then calls the overridden RenderChildren method.

// 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 a ASP.NET di eseguire il rendering di qualsiasi codice ASP (Active Server Pages) nella pagina.This method notifies ASP.NET to render any Active Server Pages (ASP) code on the page. Se nella pagina non è presente alcun codice ASP, questo metodo esegue il rendering di tutti i controlli figlio per il controllo server.If no ASP code exists on the page, this method renders any child controls for the server control. Questo metodo viene chiamato dal Render metodo.This method is called by the Render method.

Si applica a

Vedi anche