Control.RenderControl Metodo

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Restituisce il contenuto del controllo e memorizza le informazioni della tracciatura relative al controllo se questa funzionalità è attivata.

Overload

RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata.
RenderControl(HtmlTextWriter, ControlAdapter)	Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato.

RenderControl(HtmlTextWriter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di 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 RenderControl metodo per eseguire il 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 dal Render 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 HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato.

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

Classe 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, vengono acquisite le informazioni di traccia associate al controllo.

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