Control.RenderControl Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.