Metodo Control.RenderControl (HtmlTextWriter) (System.Web.UI)

Cambia visualizzazione:

ScriptFree

Riferimento a .NET Framework

Metodo Control.RenderControl (HtmlTextWriter)

Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter fornito e memorizza le informazioni di tracciatura relative al controllo se questa funzionalità è attivata.

Spazio dei nomi: System.Web.UI
Assembly: System.Web (in System.Web.dll)

Sintassi

Visual Basic

Public Overridable Sub RenderControl ( _
	writer As HtmlTextWriter _
)

public virtual void RenderControl(
	HtmlTextWriter writer
)

Visual C++

public:
virtual void RenderControl(
	HtmlTextWriter^ writer
)

abstract RenderControl : 
        writer:HtmlTextWriter -> unit 
override RenderControl : 
        writer:HtmlTextWriter -> unit

Parametri

writer: Tipo: System.Web.UI.HtmlTextWriter
Oggetto HtmlTextWriter che riceve il contenuto del controllo.

Note

Se la proprietà Visible di un controllo server è impostata su true, questo metodo determina se la funzione di traccia è attivata per la pagina. In caso positivo, le informazioni di tracciatura associate al controllo vengono memorizzate e viene effettuato il rendering del contenuto del controllo server sulla pagina.

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

Esempi

Nell'esempio riportato di seguito il metodo RenderChildren in un controllo server personalizzato viene sottoposto a override. In tal modo si determina se il controllo corrente dispone di controlli figlio nel relativo oggetto ControlCollection. In caso affermativo, viene utilizzata la proprietà Count per far scorrere l'insieme. Ogni volta che viene rilevato un controllo figlio, viene utilizzato il metodo RenderControl per eseguire il rendering del controllo figlio e di tutti i relativi controlli figlio nella pagina contenitore. L'istanza dell'oggetto XhtmlTextWriter passato al metodo viene creata dal metodo Render().

Visual Basic


' 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 'RenderChildren


      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


// 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);
}

Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Vedere anche

Riferimenti

Control Classe

Overload RenderControl

Spazio dei nomi System.Web.UI

HtmlTextWriter