Control.RenderControl Methode

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)

Parameters

Voorbeelden

In het volgende voorbeeld wordt de RenderChildren methode in een aangepast serverbeheer overschreven. Hiermee wordt bepaald of het huidige besturingselement onderliggende besturingselementen bevat in het ControlCollection object. Als dit het geval is, wordt de Count eigenschap gebruikt om de verzameling te doorlopen. Terwijl elk onderliggend besturingselement wordt aangeroepen, wordt de RenderControl methode gebruikt om het onderliggende besturingselement en alle onderliggende besturingselementen weer te geven aan de betreffende pagina. Het XhtmlTextWriter object dat aan deze methode wordt doorgegeven, wordt geïnstantieerd door de Render methode.

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

Opmerkingen

Als de eigenschap van Visible een serverbesturingselement is ingesteld op true, bepaalt deze methode of tracering is ingeschakeld voor de pagina. Zo ja, dan worden traceringsgegevens opgeslagen die zijn gekoppeld aan het besturingselement en worden de inhoud van het serverbeheer weergegeven op de pagina.

Deze methode wordt automatisch aangeroepen door de pagina tijdens de rendering, maar kan worden overschreven door ontwikkelaars van aangepaste besturingselementen.

Zie ook

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

Parameters

Opmerkingen

ASP.NET webpagina's kunnen worden gebruikt voor een breed scala aan apparaten en browsers die informatie van het web kunnen aanvragen. De Adapter eigenschap retourneert het ControlAdapter object dat het besturingselement weergeeft op het scherm van het aanvragende apparaat of de browser.

Zie Architectuuroverzicht van adaptief besturingsgedrag voor meer informatie over adapters.

Als de eigenschap van Visible een serverbesturingselement is ingesteld true op en tracering is ingeschakeld voor de pagina, wordt traceringsgegevens vastgelegd die aan het besturingselement zijn gekoppeld.

Notities voor overnemers

Wanneer u de RenderControl(HtmlTextWriter, ControlAdapter) methode in aangepaste besturingselementen overschrijft, roept u de basisklassemethode aan om ervoor te zorgen dat traceringsgegevens correct worden vastgelegd.

Zie ook

• Adapter
• ControlAdapter
• Trace
• Architectuuroverzicht van adaptief gedrag