Cette documentation est archivée et n’est pas conservée.

Control.RenderChildren, méthode

Renvoie le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni, qui écrit le contenu à rendre sur le client.

Espace de noms : System.Web.UI
Assembly : System.Web (dans system.web.dll)

protected internal virtual void RenderChildren (
	HtmlTextWriter writer
)
protected void RenderChildren (
	HtmlTextWriter writer
)
protected internal function RenderChildren (
	writer : HtmlTextWriter
)

Paramètres

writer

Objet HtmlTextWriter qui reçoit le contenu rendu.

Cette méthode prescrit à ASP.NET de rendre le résultat du code ASP (Active Server Pages) éventuel de la page. Si la page ne comprend aucun code ASP, cette méthode affiche les contrôles enfants éventuels du contrôle serveur.

L'exemple suivant substitue la méthode RenderChildren dans un contrôle serveur personnalisé. Il détermine si le contrôle en cours possède des contrôles enfants dans son objet ControlCollection. Si c'est le cas, il utilise la propriété Count pour parcourir la collection. Chaque fois qu'il identifie un contrôle enfant, il utilise la méthode RenderControl pour générer le rendu du contrôle parent et de tous ses contrôles enfants dans la page conteneur.

La méthode Render substituée appelle ensuite la méthode RenderChildren substituée.

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

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: