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

注釈

このメソッドは、ページ上の任意の Active Server Pages (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.

適用対象

こちらもご覧ください