Control.RenderChildren(HtmlTextWriter) Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements in ein bereitgestelltes HtmlTextWriter Objekt aus, das den inhalt schreibt, der auf dem Client gerendert werden soll.

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

protected internal virtual void RenderChildren(System.Web.UI.HtmlTextWriter writer);

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

Protected Friend Overridable Sub RenderChildren (writer As HtmlTextWriter)

Parameter

writer

HtmlTextWriter

Das HtmlTextWriter Objekt, das den gerenderten Inhalt empfängt.

Beispiele

Im folgenden Beispiel wird die RenderChildren Methode in einem benutzerdefinierten Serversteuerelement außer Kraft gesetzt. Es bestimmt, ob das aktuelle Steuerelement über untergeordnete Steuerelemente in seinem ControlCollection Objekt verfügt. Wenn dies der Fall ist, wird die Count Eigenschaft zum Durchlaufen der Auflistung verwendet. Da es auf jedes untergeordnete Steuerelement trifft, wird die RenderControl Methode verwendet, um das übergeordnete Steuerelement und alle untergeordneten Steuerelemente auf die enthaltende Seite zu rendern.

Die überschriebene Render Methode ruft dann die überschriebene RenderChildren Methode auf.

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

Hinweise

Mit dieser Methode wird ASP.NET benachrichtigt, um einen ASP-Code (Active Server Pages) auf der Seite zu rendern. Wenn auf der Seite kein ASP-Code vorhanden ist, rendert diese Methode alle untergeordneten Steuerelemente für das Serversteuerelement. Diese Methode wird von der Render Methode aufgerufen.

Weitere Informationen

• Render(HtmlTextWriter)
• RenderControl(HtmlTextWriter)