Control.RenderControl Méthode

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

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

Surcharges

RenderControl(HtmlTextWriter)	Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé.
RenderControl(HtmlTextWriter, ControlAdapter)	Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni.

RenderControl(HtmlTextWriter)

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé.

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

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

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

Public Overridable Sub RenderControl (writer As HtmlTextWriter)

Paramètres

writer

HtmlTextWriter

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

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

RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni.

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

writer

HtmlTextWriter

HtmlTextWriter qui reçoit le contenu du contrôle.

adapter

ControlAdapter

ControlAdapter qui définit le rendu.

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