Control.CreateChildControls メソッド

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.dll

ASP.NET ページ フレームワークによって呼び出され、ポストバックまたはレンダリングの準備として、合成ベースの実装を使うサーバー コントロールに対し、それらのコントロールに含まれる子コントロールを作成するように通知します。

protected public:
 virtual void CreateChildControls();

protected internal virtual void CreateChildControls ();

abstract member CreateChildControls : unit -> unit
override this.CreateChildControls : unit -> unit

Protected Friend Overridable Sub CreateChildControls ()

例

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

重要

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。 詳細については、「スクリプトによる攻略の概要」を参照してください。

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

' 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 、名前の競合を INamingContainer 回避するために インターフェイスを実装する必要があります。

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

こちらもご覧ください

• Controls
• ControlCollection
• ChildControlsCreated
• INamingContainer
• カスタム ASP.NET サーバー コントロールの開発
• ASP.NET Web サーバー コントロール テンプレート