Control.RenderControl-Methode (HtmlTextWriter)

Wenn Visible-Eigenschaft eines Serversteuerelements an truefestgelegt wird, bestimmt diese Methode, ob die Ablaufverfolgung für die Seite aktiviert ist. Wenn dies der Fall ist, speichert sie die Ablaufverfolgungsinformationen, die dem Steuerelement zugeordnet sind und rendert den Inhalt des Serversteuerelements auf die Seite.

Diese Methode wird automatisch von der Seite während des Renderings aufgerufen, sondern kann überschriebene Steuerelemententwickler benutzerdefinierten sein.

Das folgende Beispiel veranschaulicht die RenderChildren-Methode in einem benutzerdefinierten Serversteuerelement. Er bestimmt, ob das aktuelle Steuerelement untergeordnete Steuerelemente im ControlCollection-Objekt verfügt. Wenn dies der Fall ist, verwendet es die Count-Eigenschaft, um die Auflistung zu durchlaufen. Obwohl sie alle untergeordneten Steuerelemente auftritt, verwendet sie die RenderControl-Methode, um das untergeordnete Steuerelement und alle untergeordneten Steuerelemente, um die Seite gerendert werden soll. Das XhtmlTextWriter-Objekt, das an diese Methode übergeben wird, wird von der Render-Methode instanziiert.

// 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);
}

.NET Framework

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz