ControlCollection.Add Method
.NET Framework 3.0
Adds the specified Control object to the collection.
Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)
Assembly: System.Web (in system.web.dll)
| Exception type | Condition |
|---|---|
|
Thrown if the child parameter does not specify a control. | |
|
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 void CreateChildControls()
{
Object o = get_ViewState().get_Item("NumItems");
if (o != null) {
// Clear any existing child controls.
get_Controls().Clear();
int numItems = Convert.ToInt32(o);
for (int i = 0; i < numItems; i++) {
// Create an item.
RepeaterItem item = new RepeaterItem(i, null);
// Initialize the item from the template.
get_ItemTemplate().InstantiateIn(item);
// Add the item to the ControlCollection.
get_Controls().Add(item);
}
}
} //CreateChildControls
Community Additions
ADD
Show: