Control.RenderChildren(HtmlTextWriter) Control.RenderChildren(HtmlTextWriter) Control.RenderChildren(HtmlTextWriter) Control.RenderChildren(HtmlTextWriter) Method

Definition

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den Inhalt zum Rendern auf den Client schreibt.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

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

Das HtmlTextWriter-Objekt, das den Inhalt des dargestellten Inhalts empfängt.The HtmlTextWriter object that receives the rendered content.

Beispiele

Im folgenden Beispiel wird die RenderChildren -Methode in einem benutzerdefinierten Server Steuerelement überschrieben.The following example overrides the RenderChildren method in a custom server control. Es bestimmt, ob das aktuelle Steuerelement über untergeordnete Steuer ControlCollection Elemente im-Objekt verfügt.It determines whether the current control has any child controls in its ControlCollection object. Wenn dies der Fall ist, wird Count die-Eigenschaft verwendet, um die Auflistung zu durchlaufen.If it does, it uses the Count property to iterate through the collection. Wenn jedes untergeordnete Steuerelement gefunden wird, wird RenderControl die-Methode verwendet, um das übergeordnete Steuerelement und alle seine untergeordneten Steuerelemente auf der enthaltenden Seite zu Rendering.As it encounters each child control, it uses the RenderControl method to render the parent control, and all of its child controls, to the containing page.

Die überschriebene Render Methode ruft dann die überschriebene RenderChildren Methode auf.The overridden Render method then calls the overridden RenderChildren 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 'RenderChildren
      
      
      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, dass der ASP-Code (Active Server Pages) auf der Seite angezeigt werden soll.This method notifies ASP.NET to render any Active Server Pages (ASP) code on the page. Wenn auf der Seite kein ASP-Code vorhanden ist, rendert diese Methode alle untergeordneten Steuerelemente für das Server Steuerelement.If no ASP code exists on the page, this method renders any child controls for the server control. Diese Methode wird von der Render -Methode aufgerufen.This method is called by the Render method.

Gilt für:

Siehe auch