Control.RenderControl Methode

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

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 zum Durchlaufen der Auflistung verwendet. Wenn es auf jedes untergeordnete Steuerelement trifft, wird die RenderControl Methode verwendet, um das untergeordnete Steuerelement und alle untergeordneten Steuerelemente auf die enthaltende Seite zu rendern. 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 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 Inhalt des Serversteuerelements auf der Seite.

Diese Methode wird während des Renderings automatisch von der Seite aufgerufen, kann jedoch von benutzerdefinierten Steuerelemententwicklern überschrieben werden.

Weitere Informationen

• HtmlTextWriter

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

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 adaptives Steuerelementverhalten.

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