Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Control.RenderControl, méthode (HtmlTextWriter)

 

Renvoie 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
)

Paramètres

writer

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 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 enfant et de tous ses contrôles enfants dans la page conteneur.L'objet XhtmlTextWriter passé à cette méthode est instancié par la méthode M:System.Web.UI.Page.Render.

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

.NET Framework
Disponible depuis 1.1
Retour au début
Afficher: