Control.RenderControl Control.RenderControl Control.RenderControl Control.RenderControl Method

Definición

Genera el contenido del control de servidor y almacena información de traza del control si está habilitada la traza.Outputs server control content and stores tracing information about the control if tracing is enabled.

Sobrecargas

RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter)

Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter)

Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

public:
 virtual void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);
public virtual void RenderControl (System.Web.UI.HtmlTextWriter writer);
abstract member RenderControl : System.Web.UI.HtmlTextWriter -> unit
override this.RenderControl : System.Web.UI.HtmlTextWriter -> unit
Public Overridable Sub RenderControl (writer As HtmlTextWriter)

Parámetros

writer
HtmlTextWriter HtmlTextWriter HtmlTextWriter HtmlTextWriter

Objeto HtmlTextWriter que recibe el contenido de control.The HtmlTextWriter object that receives the control content.

Ejemplos

En el ejemplo siguiente se invalida el RenderChildren método 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 Count propiedad 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 RenderControl método para representar el control secundario y todos sus controles secundarios en la página contenedora.As it encounters each child control, it uses the RenderControl method to render the child control, and all of its child controls, to the containing page. El XhtmlTextWriter Render método crea una instancia del objeto que se pasa a este método.The XhtmlTextWriter object that is passed to this method is instantiated by the Render 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

Comentarios

Si la propiedad de un Visible control de servidor está trueestablecida en, este método determina si la traza está habilitada para la página.If a server control's Visible property is set to true, this method determines whether tracing is enabled for the page. Si es así, almacena la información de seguimiento asociada al control y representa el contenido del control de servidor en la página.If so, it stores trace information associated with the control, and renders the server control content to the page.

La página llama automáticamente a este método durante la representación, pero puede ser reemplazado por desarrolladores de controles personalizados.This method is automatically called by the page during the rendering, but can be overridden by custom control developers.

Consulte también:

RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

protected:
 void RenderControl(System::Web::UI::HtmlTextWriter ^ writer, System::Web::UI::Adapters::ControlAdapter ^ adapter);
protected void RenderControl (System.Web.UI.HtmlTextWriter writer, System.Web.UI.Adapters.ControlAdapter adapter);
member this.RenderControl : System.Web.UI.HtmlTextWriter * System.Web.UI.Adapters.ControlAdapter -> unit
Protected Sub RenderControl (writer As HtmlTextWriter, adapter As ControlAdapter)

Parámetros

writer
HtmlTextWriter HtmlTextWriter HtmlTextWriter HtmlTextWriter

Control HtmlTextWriter que recibe el contenido del control.The HtmlTextWriter that receives the control content.

adapter
ControlAdapter ControlAdapter ControlAdapter ControlAdapter

ControlAdapter que define la representación.The ControlAdapter that defines the rendering.

Comentarios

Las páginas web de ASP.NET se pueden usar en una amplia gama de dispositivos y exploradores que pueden solicitar información de la Web.ASP.NET Web pages are usable across a wide range of devices and browsers that can request information from the Web. La Adapter propiedad devuelve el ControlAdapter objeto que representa el control en la pantalla del dispositivo o del explorador que lo solicita.The Adapter property returns the ControlAdapter object that renders the control on the requesting device or browser's screen.

Para obtener más información acerca de los adaptadores, consulte información general sobre la arquitectura del comportamiento de control adaptable.For more information about adapters, see Architectural Overview of Adaptive Control Behavior.

Si la propiedad de un Visible control de servidor se true establece en y el seguimiento está habilitado para la página, se captura la información de seguimiento asociada al control.If a server control's Visible property is set to true and tracing is enabled for the page, then trace information associated with the control is captured.

Notas a los desarrolladores de herederos

Al reemplazar el RenderControl(HtmlTextWriter, ControlAdapter) método en controles personalizados, llame al método de clase base para asegurarse de que la información de seguimiento se Capture correctamente.When overriding the RenderControl(HtmlTextWriter, ControlAdapter) method in custom controls, call the base class method to ensure trace information is correctly captured.

Consulte también:

Se aplica a