Control.RenderControl Control.RenderControl Control.RenderControl Control.RenderControl Method

Définition

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é.Outputs server control content and stores tracing information about the control if tracing is enabled.

Surcharges

RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) 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é.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) 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é.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

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

Objet HtmlTextWriter qui reçoit le contenu du contrôle.The HtmlTextWriter object that receives the control content.

Exemples

L’exemple suivant substitue la RenderChildren méthode dans un contrôle serveur personnalisé.The following example overrides the RenderChildren method in a custom server control. Elle détermine si le contrôle actuel possède des contrôles enfants dans son ControlCollection objet.It determines whether the current control has any child controls in its ControlCollection object. Si c’est le cas, il Count utilise la propriété pour itérer au sein de la collection.If it does, it uses the Count property to iterate through the collection. Étant donné 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 conteneur.As it encounters each child control, it uses the RenderControl method to render the child control, and all of its child controls, to the containing page. L' XhtmlTextWriter objet qui est passé à cette méthode est instancié par la Render méthode.The XhtmlTextWriter object that is passed to this method is instantiated by the Render method.

// 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' Visible un contrôle serveur a la truevaleur, cette méthode détermine si le traçage est activé pour la page.If a server control's Visible property is set to true, this method determines whether tracing is enabled for the page. Si c’est le cas, elle stocke les informations de trace associées au contrôle et restitue le contenu du contrôle serveur sur la page.If so, it stores trace information associated with the control, and renders the server control content to the page.

Cette méthode est appelée automatiquement par la page pendant le rendu, mais peut être substituée par les développeurs de contrôles personnalisés.This method is automatically called by the page during the rendering, but can be overridden by custom control developers.

Voir aussi

RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

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

HtmlTextWriter qui reçoit le contenu du contrôle.The HtmlTextWriter that receives the control content.

adapter
ControlAdapter ControlAdapter ControlAdapter ControlAdapter

ControlAdapter qui définit le rendu.The ControlAdapter that defines the rendering.

Remarques

Les pages Web ASP.NET sont utilisables sur un large éventail d’appareils et de navigateurs qui peuvent demander des informations sur le Web.ASP.NET Web pages are usable across a wide range of devices and browsers that can request information from the Web. La Adapter propriété retourne l' ControlAdapter objet qui restitue le contrôle sur l’écran de l’appareil ou du navigateur demandeur.The Adapter property returns the ControlAdapter object that renders the control on the requesting device or browser's screen.

Pour plus d’informations sur les adaptateurs, consultez vue d’ensemble de l’architecture du comportement de contrôle adaptatif.For more information about adapters, see Architectural Overview of Adaptive Control Behavior.

Si la propriété d' Visible un contrôle serveur a la true valeur et que le traçage est activé pour la page, les informations de traçage associées au contrôle sont capturées.If a server control's Visible property is set to true and tracing is enabled for the page, then trace information associated with the control is captured.

Notes pour les héritiers

Lors de la substitution RenderControl(HtmlTextWriter, ControlAdapter) de la méthode dans les contrôles personnalisés, appelez la méthode de la classe de base pour vérifier que les informations de trace sont correctement capturées.When overriding the RenderControl(HtmlTextWriter, ControlAdapter) method in custom controls, call the base class method to ensure trace information is correctly captured.

Voir aussi

S’applique à