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 Overridable Sub RemoveAt (
	index As Integer


Type: System.Int32

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

Exception Condition

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.           
msgRemoveAt.Text = "The control at index location 1 has been removed."

.NET Framework
Available since 1.1
Return to top