Control.RenderControl Método

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Genera contenido de control de servidor y almacena información de seguimiento sobre el control si el seguimiento está habilitado.

Sobrecargas

RenderControl(HtmlTextWriter)	Genera contenido de control de servidor en un objeto de HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si el seguimiento está habilitado.
RenderControl(HtmlTextWriter, ControlAdapter)	Genera contenido de control de servidor en un objeto de HtmlTextWriter proporcionado mediante un objeto ControlAdapter proporcionado.

RenderControl(HtmlTextWriter)

Genera contenido de control de servidor en un objeto de HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si el seguimiento está habilitado.

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 del control.

Ejemplos

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

// 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 Visible de un control de servidor está establecida en true, 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.

Los desarrolladores de controles personalizados pueden invalidar este método automáticamente durante la representación, pero los desarrolladores de controles personalizados pueden invalidar este método.

Consulte también

• HtmlTextWriter

RenderControl(HtmlTextWriter, ControlAdapter)

Genera contenido de control de servidor en un objeto de HtmlTextWriter proporcionado mediante 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 HtmlTextWriter que recibe el contenido del control.

adapter

ControlAdapter

El 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 propiedad Adapter devuelve el objeto ControlAdapter que representa el control en la pantalla del dispositivo o explorador solicitante.

Para obtener más información sobre los adaptadores, consulte Introducción a la arquitectura del comportamiento del control adaptable.

Si la propiedad Visible de un control de servidor se establece en true 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 reemplazar el método RenderControl(HtmlTextWriter, ControlAdapter) 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
• Introducción a la arquitectura del comportamiento del control adaptable