ControlCollection::AddAt Method (Int32, Control^)
.NET Framework (current version)
Adds the specified Control object to the collection at the specified index location.
Assembly: System.Web (in System.Web.dll)
Parameters
- index
-
Type:
System::Int32
The location in the array at which to add the child control.
- child
-
Type:
System.Web.UI::Control^
The Control to add to the collection.
| Exception | Condition |
|---|---|
| ArgumentNullException | The child parameter does not specify a control. |
| ArgumentOutOfRangeException | The index parameter is less than zero or greater than the ControlCollection::Count property. |
| HttpException | The ControlCollection is read-only. |
The added control can be an instance of any ASP.NET server control, a custom server control you create, or a literal control.
The following code example uses the AddAt method to create a new LiteralControl named ChildControl2 and add it to the myButton control's ControlCollection collection at the index location of 1.
.NET Framework
Available since 1.1
Available since 1.1
Show: