ControlCollection.AddAt Method (Int32, Control)

 

Adds the specified Control object to the collection at the specified index location.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

public virtual void AddAt(
	int index,
	Control child
)

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
Return to top
Show: