Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
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.
Assembly : System.Web (dans System.Web.dll)
Paramètres
- writer
- Type : System.Web.UI.HtmlTextWriter
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. Cette méthode est appelée par la méthode Render.
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 itérer au sein de 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 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.