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 esegue l'override di RenderChildren metodo in un controllo server personalizzato.The following example overrides the RenderChildren method in a custom server control. Determina se il controllo corrente ha tutti i controlli figlio relativo ControlCollection oggetto.It determines whether the current control has any child controls in its ControlCollection object. In caso affermativo, utilizzata la Count proprietà per scorrere la raccolta.If it does, it uses the Count property to iterate through the collection. Che si verifica ogni controllo figlio, viene utilizzato il RenderControl metodo per eseguire il rendering l'elemento figlio, controllo e tutti i relativi controlli figlio, nella pagina che 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. Il XhtmlTextWriter oggetto che viene passato a questo metodo crea un'istanza di 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 '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

Commenti

Se un controllo server Visible è impostata su true, 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 questo caso, archivia le informazioni di traccia associate al controllo e viene eseguito il rendering del contenuto del controllo server alla 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 può essere sottoposto a 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

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

Per altre informazioni sugli adapter, vedere Architectural Overview of adattivo controllo Behavior.For more information about adapters, see Architectural Overview of Adaptive Control Behavior.

Se un controllo server Visible è impostata su true e traccia è abilitata per la pagina, quindi 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'override di RenderControl(HtmlTextWriter, ControlAdapter) metodi nei controlli personalizzati, chiamare il metodo di classe di base per verificare che le informazioni di traccia viene 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