Control.RenderChildren メソッド

.NET Framework クラス ライブラリ リファレンス

Control.RenderChildren メソッド

クライアントに表示される内容の書き込みを行う、指定された HtmlTextWriter オブジェクトに、サーバー コントロールの子を出力します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Friend Overridable
 Sub RenderChildren ( _
    writer As HtmlTextWriter _
)

Visual Basic (使用法)

Dim writer As HtmlTextWriter

Me.RenderChildren(writer)

C#

protected internal virtual void RenderChildren
 (
    HtmlTextWriter writer
)

C++

protected public:
virtual void RenderChildren (
    HtmlTextWriter^ writer
)

J#

protected void RenderChildren (
    HtmlTextWriter writer
)

JScript

protected internal function
 RenderChildren (
    writer : HtmlTextWriter
)

パラメータ

writer

表示された内容を受け取る HtmlTextWriter オブジェクト。

解説

このメソッドは、ページに ASP (Active Server Pages) コードを表示するよう ASP.NET に通知します。ページに ASP コードが存在しない場合、このメソッドはサーバー コントロールの子コントロールを表示します。

使用例

カスタム サーバー コントロールの RenderChildren メソッドをオーバーライドする例を次に示します。これは、現在のコントロールの ControlCollection オブジェクトに子コントロールがあるかどうかを判断します。子コントロールがある場合は、Count プロパティを使用してそのコレクションを反復処理します。そして、子コントロールを認識するたびに、RenderControl メソッドを使用して、配置先ページに親コントロールとそのすべての子コントロールを表示します。

オーバーライドされた Render メソッドが、オーバーライドされた RenderChildren メソッドを呼び出します。

Visual Basic

' 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

C#

// 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);
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Control クラス
Control メンバ
System.Web.UI 名前空間
Render
RenderControl