Control.RenderControl Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

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

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 in seinem ControlCollection -Objekt verfügt. Wenn dies der Fall ist, wird die Count -Eigenschaft verwendet, um die Auflistung zu durchlaufen. Da jedes untergeordnete Steuerelement angezeigt wird, wird die RenderControl -Methode verwendet, um das untergeordnete Steuerelement und alle untergeordneten Steuerelemente auf der enthaltenden Seite zu rendern. Das XhtmlTextWriter An diese Methode übergebene Objekt 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 truefestgelegt ist, bestimmt diese Methode, ob die Ablaufverfolgung für die Seite aktiviert ist. In diesem Zusammenhang werden Ablaufverfolgungsinformationen gespeichert, die dem Steuerelement zugeordnet sind, und der Inhalt des Serversteuerelements wird auf der Seite gerendert.

Diese Methode wird während des Renderings automatisch von der Seite aufgerufen, kann aber von Entwicklern benutzerdefinierter Steuerelemente überschrieben werden.

Weitere Informationen

• HtmlTextWriter

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 auf einer 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 anfordernden Gerät oder Browserbildschirm rendert.

Weitere Informationen zu Adaptern finden Sie unter Architekturübersicht über das Verhalten adaptiver Steuerungen.

Wenn die Eigenschaft eines Serversteuerelements Visible auf true festgelegt 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.

Weitere Informationen

• Adapter
• ControlAdapter
• Trace
• Architekturübersicht über das Verhalten adaptiver Steuerungen