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.
// Create a LiteralControl and use the Add method to add it // to a button's ControlCollection, then use the AddAt method // to add another LiteralControl to the collection at the // index location of 1. LiteralControl myLiteralControl = new LiteralControl("ChildControl1"); myButton.Controls.Add(myLiteralControl); myButton.Controls.AddAt(1,new LiteralControl("ChildControl2")); Response.Write("<b>ChildControl2 is added at index 1</b>"); // Get the Index location of the myLiteralControl LiteralControl // and write it to the page. Response.Write("<br /><b>Index of the ChildControl myLiteralControl is " + "</b>" + myButton.Controls.IndexOf(myLiteralControl));
.NET Framework
Available since 1.1
Available since 1.1
Show: