ControlCollection.RemoveAt Method (Int32)

 

Removes a child control, at the specified index location, from the ControlCollection object.

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

public virtual void RemoveAt(
	int index
)

Parameters

index
Type: System.Int32

The ordinal index of the server control to be removed from the collection.

Exception Condition
HttpException

Thrown if the ControlCollection is read-only.

To remove a control from the collection based on its value, use the Remove method.

The following code example uses the RemoveAt method to delete a child control from the myButton server control. The method call first specifies an index location of 1 from which the control is deleted. The example then writes to the containing page a text message saying that the control at that location has been deleted from the ControlCollection collection.

// Use the RemoveAt method to delete the child control
// at index location 1.           
myButton.Controls.RemoveAt(1);
msgRemoveAt.Text = "The control at index location 1 has been removed.";

.NET Framework
Available since 1.1
Return to top
Show: