Control.CreateControlCollection 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

创建一个新 ControlCollection 对象来保存服务器控件的子控件（包括文本控件和服务器控件）。

protected:
 virtual System::Web::UI::ControlCollection ^ CreateControlCollection();

protected virtual System.Web.UI.ControlCollection CreateControlCollection ();

abstract member CreateControlCollection : unit -> System.Web.UI.ControlCollection
override this.CreateControlCollection : unit -> System.Web.UI.ControlCollection

Protected Overridable Function CreateControlCollection () As ControlCollection

返回

ControlCollection

一个 ControlCollection 对象，用于包含当前服务器控件的子服务器控件。

示例

下面的代码示例重写CreateControlCollection方法以创建从ControlCollection类继承的CustomControlCollection类的实例。

// Override the CreateControlCollection method to 
// write to the Trace object when tracing is enabled
// for the page or application in which this control
// is included.   
protected override ControlCollection CreateControlCollection()
{
    return new CustomControlCollection(this);
}

' Override the CreateControlCollection method to 
' write to the Trace object when tracing is enabled
' for the page or application in which this control
' is included.   
Protected Overrides Function CreateControlCollection() As ControlCollection
    Return New CustomControlCollection(Me)
End Function

下面的代码示例在 CreateControlCollection 方法的 CreateChildControls 自定义服务器控件重写中使用该方法。 将创建新集合，然后填充两个子控件， firstControl 然后 secondControl填充 。

protected override void CreateChildControls()
{               
   // Creates a new ControlCollection. 
   this.CreateControlCollection();

   // Create child controls.
    ChildControl firstControl = new ChildControl();
   firstControl.Message = "FirstChildControl";

   ChildControl secondControl = new ChildControl();
   secondControl.Message = "SecondChildControl";
   
   Controls.Add(firstControl);
   Controls.Add(secondControl);

   // Prevent child controls from being created again.
   ChildControlsCreated = true;
}

Protected Overrides Sub CreateChildControls()
   ' Creates a new ControlCollection. 
   Me.CreateControlCollection()
   
   ' Create child controls.
   Dim firstControl As New ChildControl()
   firstControl.Message = "FirstChildControl"
   
   Dim secondControl As New ChildControl()
   secondControl.Message = "SecondChildControl"
   
   Controls.Add(firstControl)
   Controls.Add(secondControl)
   
   ' Prevent child controls from being created again.
   ChildControlsCreated = True
End Sub

注解

如果已创建派生自类的集合对象，请重写自定义服务器控件中的 ControlCollection 此方法。 然后，可以在此方法的重写中实例化该集合类。

另请参阅

• ControlCollection