Control.RenderChildren(HtmlTextWriter) Methode

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den auf dem Client zu rendernden Inhalt schreibt.

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

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

protected 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 Overridable Sub RenderChildren (writer As HtmlTextWriter)

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 im ControlCollection Objekt verfügt. Wenn dies der Fall ist, wird die Count Eigenschaft zum Durchlaufen der Auflistung verwendet. Da jedes untergeordnete Steuerelement auftritt, wird die RenderControl Methode zum Rendern des übergeordneten Steuerelements und aller untergeordneten Steuerelemente auf die enthaltende Seite verwendet.

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

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

Gilt für

Produkt	Versionen
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8

Freigeben über