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

Definition

Gibt Serversteuerelementinhalt aus und speichert Ablaufverfolgungsinformationen über das Steuerelement, wenn Ablaufverfolgung aktiviert ist.Outputs server control content and stores tracing information about the control if tracing is enabled.

Überlädt

RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.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)

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.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)

Parameter

writer
HtmlTextWriter HtmlTextWriter HtmlTextWriter HtmlTextWriter

Das HtmlTextWriter-Objekt, das den Inhalt des Steuerelements empfängt.The HtmlTextWriter object that receives the control content.

Beispiele

Im folgenden Beispiel wird die RenderChildren -Methode in einem benutzerdefinierten Server Steuerelement überschrieben.The following example overrides the RenderChildren method in a custom server control. Es bestimmt, ob das aktuelle Steuerelement über untergeordnete Steuer ControlCollection Elemente im-Objekt verfügt.It determines whether the current control has any child controls in its ControlCollection object. Wenn dies der Fall ist, wird Count die-Eigenschaft verwendet, um die Auflistung zu durchlaufen.If it does, it uses the Count property to iterate through the collection. Wenn jedes untergeordnete Steuerelement gefunden wird, wird RenderControl die-Methode verwendet, um das untergeordnete Steuerelement und alle seine untergeordneten Steuerelemente auf der enthaltenden Seite zu Rendering.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. Das XhtmlTextWriter an diese Methode übergebenen-Objekt wird von der Render -Methode instanziiert.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

Hinweise

Wenn die- Visible Eigenschaft eines Server Steuer Elements auf truefestgelegt ist, bestimmt diese Methode, ob die Ablauf Verfolgung für die Seite aktiviert ist.If a server control's Visible property is set to true, this method determines whether tracing is enabled for the page. Wenn dies der Fall ist, werden dem Steuerelement zugeordnete Ablauf Verfolgungs Informationen gespeichert und der Inhalt des Server Steuer Elements auf der Seite gerendert.If so, it stores trace information associated with the control, and renders the server control content to the page.

Diese Methode wird während des Renderings automatisch von der Seite aufgerufen, kann jedoch von benutzerdefinierten Steuerelement Entwicklern überschrieben werden.This method is automatically called by the page during the rendering, but can be overridden by custom control developers.

Siehe auch

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

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.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)

Parameter

writer
HtmlTextWriter HtmlTextWriter HtmlTextWriter HtmlTextWriter

Der HtmlTextWriter, der den Steuerelementinhalt empfängt.The HtmlTextWriter that receives the control content.

adapter
ControlAdapter ControlAdapter ControlAdapter ControlAdapter

Der ControlAdapter, der das Rendering definiert.The ControlAdapter that defines the rendering.

Hinweise

ASP.NET Webseiten können über eine Vielzahl von Geräten und Browsern verwendet werden, die Informationen aus dem Internet anfordern können.ASP.NET Web pages are usable across a wide range of devices and browsers that can request information from the Web. Die Adapter -Eigenschaft gibt ControlAdapter das-Objekt zurück, das das-Steuerelement auf dem anfordernden Gerät oder Browser Bildschirm rendert.The Adapter property returns the ControlAdapter object that renders the control on the requesting device or browser's screen.

Weitere Informationen zu Adaptern finden Sie unter Architektur Übersicht über das Verhalten von adaptiven SteuerElementen.For more information about adapters, see Architectural Overview of Adaptive Control Behavior.

Wenn die-Eigenschaft eines Visible Server Steuer Elements auf true festgelegt ist und die-Ablauf Verfolgung für die Seite aktiviert ist, werden Ablauf Verfolgungs Informationen aufgezeichnet, die dem Steuerelement zugeordnet sind.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.

Hinweise für Vererber

Wenn Sie die RenderControl(HtmlTextWriter, ControlAdapter) Methode in benutzerdefinierten Steuerelementen überschreiben, müssen Sie die Basisklassen Methode aufzurufen, um sicherzustellen, dass Ablauf Verfolgungs InformationenWhen overriding the RenderControl(HtmlTextWriter, ControlAdapter) method in custom controls, call the base class method to ensure trace information is correctly captured.

Siehe auch

Gilt für: