Control.RenderChildren(HtmlTextWriter) Metoda

Definice

Vypíše obsah podřízených ovládacích prvků serveru do poskytnutého HtmlTextWriter objektu, který zapisuje obsah, který má být vykreslen na klientovi.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

protected:
 virtual void RenderChildren(System::Web::UI::HtmlTextWriter ^ writer);
protected public:
 virtual void RenderChildren(System::Web::UI::HtmlTextWriter ^ writer);
protected virtual void RenderChildren (System.Web.UI.HtmlTextWriter writer);
protected internal virtual void RenderChildren (System.Web.UI.HtmlTextWriter writer);
abstract member RenderChildren : System.Web.UI.HtmlTextWriter -> unit
override this.RenderChildren : System.Web.UI.HtmlTextWriter -> unit
Protected Overridable Sub RenderChildren (writer As HtmlTextWriter)
Protected Friend Overridable Sub RenderChildren (writer As HtmlTextWriter)

Parametry

writer
HtmlTextWriter

HtmlTextWriterObjekt, který přijímá vykreslený obsah.The HtmlTextWriter object that receives the rendered content.

Příklady

Následující příklad přepisuje RenderChildren metodu ve vlastním ovládacím prvku serveru.The following example overrides the RenderChildren method in a custom server control. Určuje, zda má aktuální ovládací prvek ve svém objektu podřízené ovládací prvky ControlCollection .It determines whether the current control has any child controls in its ControlCollection object. V takovém případě používá Count vlastnost k iteraci v kolekci.If it does, it uses the Count property to iterate through the collection. Při výskytu každého podřízeného ovládacího prvku používá RenderControl metodu k vykreslení nadřazeného ovládacího prvku a všech jeho podřízených ovládacích prvků na stránku obsahující.As it encounters each child control, it uses the RenderControl method to render the parent control, and all of its child controls, to the containing page.

Přepsaná Render Metoda pak zavolá přepsanou RenderChildren metodu.The overridden Render method then calls the overridden RenderChildren 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
      
      
      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

Poznámky

Tato metoda upozorní ASP.NET na vykreslení libovolného kódu Active Server stránek (ASP) na stránce.This method notifies ASP.NET to render any Active Server Pages (ASP) code on the page. Pokud na stránce neexistuje žádný kód ASP, tato metoda vykreslí všechny podřízené ovládací prvky pro serverový ovládací prvek.If no ASP code exists on the page, this method renders any child controls for the server control. Tato metoda je volána Render metodou.This method is called by the Render method.

Platí pro

Viz také