Control.RenderControl Methode

Definition

Gibt Serversteuerelementinhalt aus und speichert Ablaufverfolgungsinformationen über das Steuerelement, wenn Ablaufverfolgung aktiviert ist.

Überlädt

RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.

RenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.

RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.

public:
 void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);
public:
 virtual void RenderControl(System::Web::UI::HtmlTextWriter ^ writer);
public void RenderControl (System.Web.UI.HtmlTextWriter writer);
public virtual void RenderControl (System.Web.UI.HtmlTextWriter writer);
member this.RenderControl : System.Web.UI.HtmlTextWriter -> unit
abstract member RenderControl : System.Web.UI.HtmlTextWriter -> unit
override this.RenderControl : System.Web.UI.HtmlTextWriter -> unit
Public Sub RenderControl (writer As HtmlTextWriter)
Public Overridable Sub RenderControl (writer As HtmlTextWriter)

Parameter

writer
HtmlTextWriter

Das HtmlTextWriter-Objekt, das den Inhalt des Steuerelements empfängt.

Beispiele

Im folgenden Beispiel wird die RenderChildren Methode in einem benutzerdefinierten Serversteuerelement außer Kraft gesetzt. Es bestimmt, ob das aktuelle Steuerelement über untergeordnete Steuerelemente im ControlCollection Objekt verfügt. Wenn dies der Fall ist, wird die Count Eigenschaft zum Durchlaufen der Auflistung verwendet. Da jedes untergeordnete Steuerelement auftritt, wird die RenderControl Methode zum Rendern des untergeordneten Steuerelements und aller untergeordneten Steuerelemente auf die enthaltende Seite verwendet. Das XhtmlTextWriter Objekt, das an diese Methode übergeben wird, wird von der Render Methode instanziiert.

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

Hinweise

Wenn die Eigenschaft eines Serversteuerelements Visible auf true"Festgelegt" festgelegt ist, bestimmt diese Methode, ob die Ablaufverfolgung für die Seite aktiviert ist. Wenn ja, speichert sie Ablaufverfolgungsinformationen, die dem Steuerelement zugeordnet sind, und rendert den Serversteuerelementinhalt auf der Seite.

Diese Methode wird während des Renderings automatisch von der Seite aufgerufen, kann jedoch von benutzerdefinierten Steuerelemententwicklern außer Kraft gesetzt werden.

Siehe auch

Gilt für:

RenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.

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

Der HtmlTextWriter, der den Steuerelementinhalt empfängt.

adapter
ControlAdapter

Der ControlAdapter, der das Rendering definiert.

Hinweise

ASP.NET Webseiten können über eine Vielzahl von Geräten und Browsern verwendet werden, die Informationen aus dem Web anfordern können. Die Adapter Eigenschaft gibt das ControlAdapter Objekt zurück, das das Steuerelement auf dem bildschirm des anfordernden Geräts oder Browsers rendert.

Weitere Informationen zu Adaptern finden Sie unter "Architekturübersicht über adaptives Steuerelementverhalten".

Wenn die Eigenschaft eines Serversteuerelements Visible auf die Seite festgelegt true ist und die Ablaufverfolgung für die Seite aktiviert ist, werden ablaufverfolgungsinformationen erfasst, die dem Steuerelement zugeordnet sind.

Hinweise für Vererber

Rufen Sie beim Überschreiben der RenderControl(HtmlTextWriter, ControlAdapter) Methode in benutzerdefinierten Steuerelementen die Basisklassenmethode auf, um sicherzustellen, dass Ablaufverfolgungsinformationen ordnungsgemäß erfasst werden.

Siehe auch

Gilt für: