Control.RenderControl Control.RenderControl Control.RenderControl Control.RenderControl Method

Definizione

Restituisce il contenuto del controllo e memorizza le informazioni della tracciatura relative al controllo se questa funzionalità è attivata.Outputs server control content and stores tracing information about the control if tracing is enabled.

Overload

RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) 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.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) 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.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

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

Oggetto HtmlTextWriter che riceve il contenuto del controllo.The HtmlTextWriter object that receives the control content.

Esempi

Nell'esempio seguente viene eseguito RenderChildren l'override del metodo in un controllo server personalizzato.The following example overrides the RenderChildren method in a custom server control. Determina se il controllo corrente dispone di controlli figlio nell' ControlCollection oggetto.It determines whether the current control has any child controls in its ControlCollection object. In caso affermativo, usa la Count proprietà per scorrere l'insieme.If it does, it uses the Count property to iterate through the collection. Quando incontra ogni controllo figlio, usa il RenderControl metodo per eseguire il rendering del controllo figlio e di tutti i relativi controlli figlio nella pagina che lo contiene.As it encounters each child control, it uses the RenderControl method to render the child control, and all of its child controls, to the containing page. Viene XhtmlTextWriter creata un'istanza dell'oggetto passato a questo metodo tramite il Render metodo.The XhtmlTextWriter object that is passed to this method is instantiated by the Render method.

// 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 Visible proprietà di un controllo server è impostata truesu, questo metodo determina se la traccia è abilitata per la pagina.If a server control's Visible property is set to true, this method determines whether tracing is enabled for the page. In tal caso, archivia le informazioni di traccia associate al controllo ed esegue il rendering del contenuto del controllo server nella pagina.If so, it stores trace information associated with the control, and renders the server control content to the page.

Questo metodo viene chiamato automaticamente dalla pagina durante il rendering, ma è possibile eseguirne l'override dagli sviluppatori di controlli personalizzati.This method is automatically called by the page during the rendering, but can be overridden by custom control developers.

Vedi anche

RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

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

Oggetto HtmlTextWriter che riceve il contenuto del controllo.The HtmlTextWriter that receives the control content.

adapter
ControlAdapter ControlAdapter ControlAdapter ControlAdapter

Classe ControlAdapter che definisce il rendering.The ControlAdapter that defines the rendering.

Commenti

Le pagine Web di ASP.NET sono utilizzabili in un'ampia gamma di dispositivi e browser che possono richiedere informazioni dal Web.ASP.NET Web pages are usable across a wide range of devices and browsers that can request information from the Web. La Adapter proprietà restituisce l' ControlAdapter oggetto che esegue il rendering del controllo nella schermata del dispositivo o del browser richiedente.The Adapter property returns the ControlAdapter object that renders the control on the requesting device or browser's screen.

Per ulteriori informazioni sugli adapter, vedere Cenni preliminari sull'architettura del comportamento del controllo adattivo.For more information about adapters, see Architectural Overview of Adaptive Control Behavior.

Se la Visible proprietà di un controllo server è impostata true su e la traccia è abilitata per la pagina, vengono acquisite le informazioni di traccia associate al controllo.If a server control's Visible property is set to true and tracing is enabled for the page, then trace information associated with the control is captured.

Note per gli eredi

Quando si esegue l' RenderControl(HtmlTextWriter, ControlAdapter) override del metodo nei controlli personalizzati, chiamare il metodo della classe base per assicurarsi che le informazioni di traccia vengano acquisite correttamente.When overriding the RenderControl(HtmlTextWriter, ControlAdapter) method in custom controls, call the base class method to ensure trace information is correctly captured.

Vedi anche

Si applica a