Control.CreateControlCollection Method
.NET Framework 2.0
Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.
Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)
Assembly: System.Web (in system.web.dll)
'Declaration Protected Overridable Function CreateControlCollection As ControlCollection 'Usage Dim returnValue As ControlCollection returnValue = Me.CreateControlCollection
protected ControlCollection CreateControlCollection ()
protected function CreateControlCollection () : ControlCollection
Not applicable.
Return Value
A ControlCollection object to contain the current server control's child server controls.The following code example overrides the CreateControlCollection method to create an instance of a CustomControlCollection class, which inherits from the ControlCollection class.
' 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
The following code example uses the CreateControlCollection method in a custom server control override of the CreateChildControls method. The new collection is created, and then populated with two child controls, firstControl and secondControl.
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 'CreateChildControls
Community Additions
ADD
Show: