Control.RenderControl Metodo

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Restituisce il contenuto del controllo server e archivia le informazioni di traccia sul controllo se la traccia è abilitata.

Overload

Nome	Descrizione
RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata.
RenderControl(HtmlTextWriter, ControlAdapter)	Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter .

RenderControl(HtmlTextWriter)

Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata.

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)

Parametri

writer

HtmlTextWriter

Oggetto HtmlTextWriter che riceve il contenuto del controllo.

Esempio

Nell'esempio seguente viene eseguito l'override del RenderChildren metodo in un controllo server personalizzato. Determina se il controllo corrente dispone di controlli figlio nel relativo ControlCollection oggetto. In caso affermativo, usa la Count proprietà per scorrere l'insieme. Quando rileva ogni controllo figlio, usa il metodo per eseguire il RenderControl rendering del controllo figlio e di tutti i relativi controlli figlio nella pagina contenitore. L'oggetto XhtmlTextWriter passato a questo metodo viene creata un'istanza Render dal metodo .

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

Commenti

Se la proprietà di Visible un controllo server è impostata su true, questo metodo determina se la traccia è abilitata per la pagina. In tal caso, archivia le informazioni di traccia associate al controllo ed esegue il rendering del contenuto del controllo server nella pagina.

Questo metodo viene chiamato automaticamente dalla pagina durante il rendering, ma può essere sottoposto a override dagli sviluppatori di controlli personalizzati.

Vedi anche

• HtmlTextWriter

RenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter .

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)

Parametri

writer

HtmlTextWriter

Oggetto HtmlTextWriter che riceve il contenuto del controllo.

adapter

ControlAdapter

Oggetto ControlAdapter che definisce il rendering.

Commenti

ASP.NET pagine Web sono utilizzabili in un'ampia gamma di dispositivi e browser che possono richiedere informazioni dal Web. La Adapter proprietà restituisce l'oggetto ControlAdapter che esegue il rendering del controllo sullo schermo del dispositivo o del browser richiedente.

Per altre informazioni sugli adattatori, vedere Cenni preliminari sull'architettura del comportamento del controllo adattivo.

Se la proprietà di Visible un controllo server è impostata su true e la traccia è abilitata per la pagina, le informazioni di traccia associate al controllo vengono acquisite.

Note per gli eredi

Quando si esegue l'override del RenderControl(HtmlTextWriter, ControlAdapter) metodo nei controlli personalizzati, chiamare il metodo della classe base per assicurarsi che le informazioni di traccia vengano acquisite correttamente.

Vedi anche

• Adapter
• ControlAdapter
• Trace
• Panoramica dell'architettura del comportamento del controllo adattivo