Control.RenderChildren(HtmlTextWriter) 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

將伺服器控制項子系的內容輸出至提供的 HtmlTextWriter 物件，再由這個物件在用戶端上寫入要轉譯的內容。

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 物件。

範例

下列範例會 RenderChildren 覆寫自訂伺服器控制項中的 方法。 它會判斷目前控制項在其 物件中 ControlCollection 是否有任何子控制項。 如果這樣做，它會使用 Count 屬性逐一查看集合。 當遇到每個子控制項時，它會使用 RenderControl 方法將父控制項及其所有子控制項轉譯至包含的頁面。

覆寫 Render 的方法接著會呼叫覆寫 RenderChildren 的方法。

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

備註

這個方法會通知 ASP.NET 轉譯頁面上的任何 Active Server Pages (ASP) 程式碼。 如果頁面上沒有任何 ASP 程式碼存在，這個方法會轉譯伺服器控制項的任何子控制項。 此方法是由 Render 方法呼叫。

另請參閱

• Render(HtmlTextWriter)
• RenderControl(HtmlTextWriter)