Control.RenderChildren(HtmlTextWriter) Control.RenderChildren(HtmlTextWriter) Control.RenderChildren(HtmlTextWriter) Control.RenderChildren(HtmlTextWriter) Method

定義

輸出伺服器控制項之子控制項的內容至提供的 HtmlTextWriter 物件,這個物件會寫入用戶端上所要呈現的內容。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 public:
 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 Friend Overridable Sub RenderChildren (writer As HtmlTextWriter)

參數

writer
HtmlTextWriter HtmlTextWriter HtmlTextWriter HtmlTextWriter

接收所呈現內容的 HtmlTextWriter 物件。The HtmlTextWriter object that receives the rendered content.

範例

下列範例會覆寫RenderChildren自訂伺服器控制項中的方法。The following example overrides the RenderChildren method in a custom server control. 它會判斷目前的控制項是否有任何子控制項,其ControlCollection物件。It determines whether the current control has any child controls in its ControlCollection object. 若是如此,它會使用Count來逐一查看集合的屬性。If it does, it uses the Count property to iterate through the collection. 當它遇到每個子控制項,它會使用RenderControl呈現父控制項,以及所有子控制項,包含頁面的方法。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.

覆寫Render然後方法會呼叫覆寫RenderChildren方法。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 'RenderChildren
      
      
      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

備註

這個方法會通知 ASP.NET 在呈現頁面上的任何 Active Server Pages (ASP) 程式碼。This method notifies ASP.NET to render any Active Server Pages (ASP) code on the page. 如果 ASP 程式碼不存在該頁面上,這個方法會呈現任何的子伺服器控制項的控制項。If no ASP code exists on the page, this method renders any child controls for the server control. 這個方法會呼叫Render方法。This method is called by the Render method.

適用於

另請參閱