Control.RenderControl Méthode

public:
 void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);

public:
 virtual void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);

public void RenderControl (System.Web.UI.HtmlTextWriter writer);

public virtual void RenderControl (System.Web.UI.HtmlTextWriter writer);

member this.RenderControl : System.Web.UI.HtmlTextWriter -> unit

abstract member RenderControl : System.Web.UI.HtmlTextWriter -> unit
override this.RenderControl : System.Web.UI.HtmlTextWriter -> unit

Public Sub RenderControl (writer As HtmlTextWriter)

Public Overridable Sub RenderControl (writer As HtmlTextWriter)

Paramètres

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 enfant et tous ses contrôles enfants sur la page contenante. L’objet XhtmlTextWriter passé à cette méthode est instancié par la Render méthode .

// 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

Si la propriété d’un Visible contrôle serveur a la truevaleur , cette méthode détermine si le suivi est activé pour la page. Si c’est le cas, il stocke les informations de trace associées au contrôle et restitue le contenu du contrôle serveur dans la page.

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

Voir aussi

• HtmlTextWriter

protected:
 void RenderControl(System::Web::UI::HtmlTextWriter ^ writer, System::Web::UI::Adapters::ControlAdapter ^ adapter);

protected void RenderControl (System.Web.UI.HtmlTextWriter writer, System.Web.UI.Adapters.ControlAdapter adapter);

member this.RenderControl : System.Web.UI.HtmlTextWriter * System.Web.UI.Adapters.ControlAdapter -> unit

Protected Sub RenderControl (writer As HtmlTextWriter, adapter As ControlAdapter)

Paramètres

Remarques

ASP.NET pages Web sont utilisables sur un large éventail d’appareils et de navigateurs qui peuvent demander des informations à partir du Web. La Adapter propriété retourne l’objet ControlAdapter qui affiche le contrôle sur l’écran de l’appareil ou du navigateur demandeur.

Pour plus d’informations sur les adaptateurs, consultez Vue d’ensemble de l’architecture du comportement du contrôle adaptatif.

Si la propriété d’un Visible contrôle serveur est définie true sur et que le suivi est activé pour la page, les informations de trace associées au contrôle sont capturées.

Notes pour les héritiers

Lorsque vous substituez la RenderControl(HtmlTextWriter, ControlAdapter) méthode dans des contrôles personnalisés, appelez la méthode de classe de base pour vous assurer que les informations de trace sont correctement capturées.

Voir aussi

• Adapter
• ControlAdapter
• Trace
• Vue d’ensemble architecturale du comportement du contrôle adaptatif