Adds the specified Control object to the collection.
Assembly: System.Web (in System.Web.dll)
Public Overridable Sub Add ( _
child As [%$TOPIC/hc8wcaf8_en-us_VS_110_2_0_0_0_0%] _
)public virtual void Add(
[%$TOPIC/hc8wcaf8_en-us_VS_110_2_0_1_0_0%] child
)public:
virtual void Add(
[%$TOPIC/hc8wcaf8_en-us_VS_110_2_0_2_0_0%]^ child
)abstract Add :
child:[%$TOPIC/hc8wcaf8_en-us_VS_110_2_0_3_0_0%] -> unit
override Add :
child:[%$TOPIC/hc8wcaf8_en-us_VS_110_2_0_3_0_1%] -> unitParameters
- child
- Type:
System.Web.UIControl
The Control to add to the collection.
| 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// Override to create repeated items.
protected override void CreateChildControls() {
object o = ViewState["NumItems"];
if (o != null) {
// Clear any existing child controls.
Controls.Clear();
int numItems = (int)o;
for (int i=0; i < numItems; i++) {
// Create an item.
RepeaterItem item = new RepeaterItem(i, null);
// Initialize the item from the template.
ItemTemplate.InstantiateIn(item);
// Add the item to the ControlCollection.
Controls.Add(item);
}
}
}Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
