Control.RenderChildren(HtmlTextWriter) Control.RenderChildren(HtmlTextWriter) Control.RenderChildren(HtmlTextWriter) Control.RenderChildren(HtmlTextWriter) Method

Définition

Renvoie le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni, qui écrit le contenu à rendre sur le 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 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)

Paramètres

writer
HtmlTextWriter HtmlTextWriter HtmlTextWriter HtmlTextWriter

Objet HtmlTextWriter qui reçoit le contenu rendu.The HtmlTextWriter object that receives the rendered content.

Exemples

L’exemple suivant substitue la RenderChildren méthode dans un contrôle serveur personnalisé.The following example overrides the RenderChildren method in a custom server control. Elle détermine si le contrôle actuel possède des contrôles enfants dans son ControlCollection objet.It determines whether the current control has any child controls in its ControlCollection object. Si c’est le cas, il Count utilise la propriété pour itérer au sein de la collection.If it does, it uses the Count property to iterate through the collection. Étant donné qu’il rencontre chaque contrôle enfant, il utilise la RenderControl méthode pour restituer le contrôle parent et tous ses contrôles enfants sur la page conteneur.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.

La méthode substituée Render appelle ensuite la méthode substituée 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

Remarques

Cette méthode indique à ASP.NET de restituer tout code ASP (Active Server Pages) sur la page.This method notifies ASP.NET to render any Active Server Pages (ASP) code on the page. Si aucun code ASP n’existe sur la page, cette méthode restitue tous les contrôles enfants pour le contrôle serveur.If no ASP code exists on the page, this method renders any child controls for the server control. Cette méthode est appelée par la Render méthode.This method is called by the Render method.

S’applique à

Voir aussi