Control.RenderControl Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Genera el contenido del control de servidor y almacena información de traza del control si está habilitada la traza.

Sobrecargas

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.
RenderControl(HtmlTextWriter, ControlAdapter)	Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.

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.

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

Objeto HtmlTextWriter que recibe el contenido de control.

Ejemplos

En el ejemplo siguiente se reemplaza el RenderChildren método en un control de servidor personalizado. Determina si el control actual tiene controles secundarios en su ControlCollection objeto . Si lo hace, usa la Count propiedad para recorrer en iteración la colección. A medida que encuentra cada control secundario, usa el RenderControl método para representar el control secundario, y todos sus controles secundarios, en la página contenedora. El XhtmlTextWriter método crea una instancia del Render objeto que se pasa a este método.

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

Comentarios

Si la propiedad de un control de Visible servidor está establecida trueen , este método determina si el seguimiento está habilitado para la página. Si es así, almacena información de seguimiento asociada al control y representa el contenido del control de servidor en la página.

La página llama automáticamente a este método durante la representación, pero los desarrolladores de controles personalizados pueden invalidarlo.

Consulte también

• HtmlTextWriter

RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.

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

El objeto HtmlTextWriter que recibe el contenido del control.

adapter

ControlAdapter

ControlAdapter que define la representación.

Comentarios

ASP.NET páginas web se pueden usar en una amplia gama de dispositivos y exploradores que pueden solicitar información de la Web. La Adapter propiedad devuelve el ControlAdapter objeto que representa el control en la pantalla del dispositivo o explorador solicitante.

Para obtener más información sobre los adaptadores, vea Información general sobre la arquitectura del comportamiento del control adaptable.

Si la propiedad de un control de Visible servidor está establecida true en y el seguimiento está habilitado para la página, se captura la información de seguimiento asociada al control.

Notas a los desarrolladores de herederos

Al invalidar 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 captura correctamente.

Consulte también

• Adapter
• ControlAdapter
• Trace
• Información general sobre la arquitectura del comportamiento del control adaptable