Control.RenderControl Método

  • Referência

Definição

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Gera o conteúdo do controle de servidor e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado.

Sobrecargas

RenderControl(HtmlTextWriter)

Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado.
RenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.

RenderControl(HtmlTextWriter)

Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado.

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

writer
HtmlTextWriter

O objeto HtmlTextWriter que recebe o conteúdo do controle.

Exemplos

O exemplo a seguir substitui o RenderChildren método em um controle de servidor personalizado. Ele determina se o controle atual tem controles filho em seu ControlCollection objeto. Se isso acontecer, ele usará a Count propriedade para iterar por meio da coleção. À medida que encontra cada controle filho, ele usa o RenderControl método para renderizar o controle filho, e todos os seus controles filho, para a página que contém. O XhtmlTextWriter objeto que é passado para esse 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

Comentários

Se a propriedade de um controle de Visible servidor estiver definida como true, esse método determinará se o rastreamento está habilitado para a página. Nesse caso, ele armazena informações de rastreamento associadas ao controle e renderiza o conteúdo do controle do servidor para a página.

Esse método é chamado automaticamente pela página durante a renderização, mas pode ser substituído por desenvolvedores de controle personalizado.

Confira também

Aplica-se a

RenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.

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

O HtmlTextWriter que recebe o conteúdo do controle.

adapter
ControlAdapter

O ControlAdapter que define a renderização.

Comentários

ASP.NET páginas da Web são utilizáveis em uma ampla variedade de dispositivos e navegadores que podem solicitar informações da Web. A Adapter propriedade retorna o ControlAdapter objeto que renderiza o controle na tela do dispositivo solicitante ou do navegador.

Para obter mais informações sobre adaptadores, consulte Visão geral de arquitetura do comportamento de controle adaptável.

Se a propriedade de um controle de Visible servidor estiver definida true e o rastreamento estiver habilitado para a página, as informações de rastreamento associadas ao controle serão capturadas.

Notas aos Herdeiros

Ao substituir o RenderControl(HtmlTextWriter, ControlAdapter) método em controles personalizados, chame o método de classe base para garantir que as informações de rastreamento sejam capturadas corretamente.

Confira também

Aplica-se a