Control.RenderControl Método

public:
 void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);

public:
 virtual void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);

public void RenderControl(System.Web.UI.HtmlTextWriter writer);

public virtual void RenderControl(System.Web.UI.HtmlTextWriter writer);

member this.RenderControl : System.Web.UI.HtmlTextWriter -> unit

abstract member RenderControl : System.Web.UI.HtmlTextWriter -> unit
override this.RenderControl : System.Web.UI.HtmlTextWriter -> unit

Public Sub RenderControl (writer As HtmlTextWriter)

Public Overridable Sub RenderControl (writer As HtmlTextWriter)

Parâmetros

Exemplos

O exemplo seguinte sobrepõe o RenderChildren método num controlo personalizado de servidor. Determina se o controlo atual tem algum controlo filho no seu ControlCollection objeto. Se o fizer, usa a Count propriedade para iterar pela coleção. À medida que encontra cada controlo filho, utiliza o RenderControl método para renderizar o controlo filho, e todos os seus controlos filhos, para a página que contém. O XhtmlTextWriter objeto que é passado para este método é instanciado pelo Render 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

Observações

Se a propriedade de Visible um controlo de servidor estiver definida para true, este método determina se o rastreamento está ativado para a página. Se sim, armazena a informação de rastreio associada ao controlo e gera o conteúdo do controlo do servidor na página.

Este método é automaticamente chamado pela página durante a renderização, mas pode ser sobreposto por programadores de controlo personalizados.

Ver também

• HtmlTextWriter

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

Observações

As páginas Web ASP.NET são utilizáveis numa vasta gama de dispositivos e navegadores que podem solicitar informação da Web. A Adapter propriedade devolve o ControlAdapter objeto que renderiza o controlo no ecrã do dispositivo solicitante ou do navegador.

Para mais informações sobre adaptadores, consulte Visão Geral Arquitetónica do Comportamento de Controlo Adaptativo.

Se a propriedade de Visible um controlo de servidor estiver definida como true e o rastreamento estiver ativado para a página, então a informação de rastreio associada ao controlo é capturada.

Notas para Herdeiros

Ao sobrepor o RenderControl(HtmlTextWriter, ControlAdapter) método em controlos personalizados, chama o método da classe base para garantir que a informação de rastreio é corretamente capturada.

Ver também

• Adapter
• ControlAdapter
• Trace
• Visão Geral Arquitetónica do Comportamento de Controlo Adaptativo