Control.RenderChildren(HtmlTextWriter) Method

Definition

Envía el contenido de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente.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:
 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)

Parameters

writer
HtmlTextWriter

El objeto HtmlTextWriter que recibe el contenido representado.The HtmlTextWriter object that receives the rendered content.

Examples

En el ejemplo siguiente se invalida el método RenderChildren en un control de servidor personalizado.The following example overrides the RenderChildren method in a custom server control. Determina si el control actual tiene controles secundarios en su ControlCollection objeto.It determines whether the current control has any child controls in its ControlCollection object. Si lo hace, utiliza la propiedad Count para recorrer en iteración la colección.If it does, it uses the Count property to iterate through the collection. Como encuentra cada control secundario, usa el método RenderControl para representar el control primario y todos sus controles secundarios en la página contenedora.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.

A continuación, el método invalidado Render llama al método RenderChildren invalidado.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
      
      
      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

Remarks

Este método notifica a ASP.NET que represente cualquier código de páginas Active Server (ASP) en la página.This method notifies ASP.NET to render any Active Server Pages (ASP) code on the page. Si no existe código ASP en la página, este método representa los controles secundarios del control de servidor.If no ASP code exists on the page, this method renders any child controls for the server control. El método Render llama a este método.This method is called by the Render method.

Applies to

See also