Control.RenderChildren(HtmlTextWriter) メソッド


クライアントに表示される内容の書き込みを行う、指定された 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)



表示された内容を受け取る 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)

protected override void Render(HtmlTextWriter output)
   output.Write("<br>Message from Control : " + Message);       
   output.Write("Showing Custom controls created in reverse" +
   // Render Controls.
' 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

         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.
      End Sub
   End Class


このメソッドは、ページに Active Server ページ (ASP) コードを表示するように ASP.NET に通知します。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.