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

Control.RenderControl, méthode (HtmlTextWriter)

Mise à jour : novembre 2007

Extrait le contenu du contrôle serveur dans un objet HtmlTextWriter fourni et stocke des informations de traçage au sujet du contrôle si le traçage est activé.

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

public virtual void RenderControl(
	HtmlTextWriter writer
)
public void RenderControl(
	HtmlTextWriter writer
)
public function RenderControl(
	writer : HtmlTextWriter
)

Paramètres

writer
Type : System.Web.UI.HtmlTextWriter

Objet HTmlTextWriter qui reçoit le contenu du contrôle.

Si la valeur true est affectée à la propriété Visible d'un contrôle serveur, cette méthode détermine si le traçage est activé pour la page. Si c'est le cas, elle stocke des informations de traçage associées au contrôle et rend le contenu du contrôle serveur sur la page.

Cette méthode est appelée automatiquement par la page pendant le rendu, mais elle peut être substituée par les développeurs de contrôles personnalisés.

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 enfant et de tous ses contrôles enfants dans la page conteneur.

// 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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0
Afficher: