Control.RenderChildren(HtmlTextWriter) Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI
Assembly:
System.Web.dll

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

protected:
 virtual void RenderChildren(System::Web::UI::HtmlTextWriter ^ writer);
protected public:
 virtual void RenderChildren(System::Web::UI::HtmlTextWriter ^ writer);
protected 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 Overridable Sub RenderChildren (writer As HtmlTextWriter)
Protected Friend Overridable Sub RenderChildren (writer As HtmlTextWriter)

Paramètres

writer
HtmlTextWriter

Objet HtmlTextWriter qui reçoit le contenu rendu.

Exemples

L’exemple suivant remplace la RenderChildren méthode dans un contrôle serveur personnalisé. Il détermine si le contrôle actuel a des contrôles enfants dans son ControlCollection objet. Si c’est le cas, il utilise la Count propriété pour itérer dans la collection. À mesure 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 contenante.

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

// 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 avertit ASP.NET de restituer tout code ASP (Active Server Pages) sur la page. S’il n’existe aucun code ASP sur la page, cette méthode affiche tous les contrôles enfants pour le contrôle serveur. Cette méthode est appelée par la Render méthode .

S’applique à

Voir aussi