ControlCollection.RemoveAt(Int32) Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Remove um controle filho, no local do índice especificado, do objeto ControlCollection.

public:
 virtual void RemoveAt(int index);

public virtual void RemoveAt (int index);

abstract member RemoveAt : int -> unit
override this.RemoveAt : int -> unit

Public Overridable Sub RemoveAt (index As Integer)

Parâmetros

index

Int32

O índice ordinal do controle de servidor a ser removido da coleção.

Exceções

HttpException

O ControlCollection é somente leitura.

Exemplos

O exemplo de código a seguir usa o RemoveAt método para excluir um controle filho do controle do myButton servidor. A chamada de método especifica primeiro um local de índice de 1 do qual o controle é excluído. Em seguida, o exemplo grava na página que contém uma mensagem de texto dizendo que o controle naquele local foi excluído da ControlCollection coleção.

// 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.";

' 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."

Comentários

Para remover um controle da coleção com base em seu valor, use o Remove método.

Confira também

• Controls
• Remove(Control)