ControlCollection.Add Method (Control)
.NET Framework (current version)
Adds the specified Control object to the collection.
Assembly: System.Web (in System.Web.dll)
| Exception | Condition |
|---|---|
| ArgumentNullException | Thrown if the child parameter does not specify a control. |
| HttpException | Thrown if the ControlCollection is read-only. |
The new control is added to the end of an ordinal index array. The control can be an instance of any ASP.NET server control, a custom server control you create, or a literal control.
To add a control to the collection at a specific index location, use the AddAt method.
The following code example uses the Add method to add a series of template items, the number of which are taken from the server control's view state, to a custom templated control.
' Override to create repeated items. Protected Overrides Sub CreateChildControls() Dim O As Object = ViewState("NumItems") If Not (O Is Nothing) ' Clear any existing child controls. Controls.Clear() Dim I As Integer Dim NumItems As Integer = CInt(O) For I = 0 To NumItems - 1 ' Create an item. Dim Item As RepeaterItemVB = New RepeaterItemVB(I, Nothing) ' Initialize the item from the template. ItemTemplate.InstantiateIn(Item) ' Add the item to the ControlCollection. Controls.Add(Item) Next End If End Sub
.NET Framework
Available since 1.1
Available since 1.1
Show: