Control.CreateChildControls メソッド

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

Control.CreateChildControls メソッド

ASP.NET ページ フレームワークによって呼び出され、コンポジション ベースの実装を使用するサーバー コントロールに、ポスト バックまたは表示のための準備として、格納する子コントロールを作成するように通知します。

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

Visual Basic (宣言)

Protected Friend Overridable
 Sub CreateChildControls

Visual Basic (使用法)

Me.CreateChildControls

C#

protected internal virtual void CreateChildControls
 ()

C++

protected public:
virtual void CreateChildControls ()

J#

protected void CreateChildControls ()

JScript

protected internal function
 CreateChildControls ()

解説

複合コントロールまたはテンプレート宣言されたサーバー コントロールを開発する場合は、このメソッドをオーバーライドする必要があります。CreateChildControls メソッドをオーバーライドするコントロールの場合、名前の衝突を避けるために、INamingContainer インターフェイスを実装してください。

詳細については、ASP.NET Web サーバー コントロール テンプレート、ASP.NET カスタム サーバー コントロールの開発 の各トピックを参照してください。

使用例

CreateChildControls メソッドのオーバーライドされたバージョンの例を次に示します。この実装では、複合コントロールは、HTML を表示する 2 つのリテラル コントロールに囲まれた TextBox コントロールを表示します。

Visual Basic

' Override CreateChildControls to create the control tree.
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand,
 Name:="Execution")> _
Protected Overrides Sub
 CreateChildControls()
   
   ' Add a LiteralControl to the current ControlCollection.
   Me.Controls.Add(New LiteralControl("<h3>Value:
 "))
   
   
   ' Create a text box control, set the default Text property, 
   ' and add it to the ControlCollection.
   Dim box As New TextBox()
   box.Text = "0"
   Me.Controls.Add(box)
   
   Me.Controls.Add(New LiteralControl("</h3>"))
End Sub 'CreateChildControls

C#

// Override CreateChildControls to create the control tree.
 [System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand,
 Name="Execution")]
 protected override void CreateChildControls()
 {

     // Add a LiteralControl to the current ControlCollection.
     this.Controls.Add(new LiteralControl("<h3>Value:
 "));


     // Create a text box control, set the default Text property, 
     // and add it to the ControlCollection.
     TextBox box = new TextBox();
     box.Text = "0";
     this.Controls.Add(box);

     this.Controls.Add(new LiteralControl("</h3>"));
 }

J#

// Override CreateChildControls to create the control tree.
/** @attribute System.Security.Permissions.PermissionSet(
    System.Security.Permissions.SecurityAction.Demand, Name = "Execution")
 */
protected void CreateChildControls()
{
    // Add a LiteralControl to the current ControlCollection.
    this.get_Controls().Add(new LiteralControl("<h3>Value:
 "));
    // Create a text box control, set the default Text property, 
    // and add it to the ControlCollection.
    TextBox box = new TextBox();
    box.set_Text("0");
    this.get_Controls().Add(box);

    this.get_Controls().Add(new LiteralControl("</h3>"));
} //CreateChildControls

JScript

// Override CreateChildControls to create the control tree.
 protected override function CreateChildControls()
 
 {

     // Add a LiteralControl to the current ControlCollection.
     this.Controls.Add(new LiteralControl("<h3>Value:
 "));

     // Create a text box control, set the default Text property, 
     // and add it to the ControlCollection.
     var box : TextBox = new TextBox();
     box.Text = "0";
     this.Controls.Add(box);

     this.Controls.Add(new LiteralControl("</h3>"));
 }

プラットフォーム

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 名前空間
Controls
ControlCollection
ChildControlsCreated
INamingContainer
その他の技術情報
ASP.NET カスタム サーバー コントロールの開発
ASP.NET Web サーバー コントロール テンプレート