ControlCollection.Remove(Control) Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Remove o servidor especificado do objeto ControlCollection do controle de servidor pai.

public:
 virtual void Remove(System::Web::UI::Control ^ value);

public virtual void Remove (System.Web.UI.Control value);

abstract member Remove : System.Web.UI.Control -> unit
override this.Remove : System.Web.UI.Control -> unit

Public Overridable Sub Remove (value As Control)

Parâmetros

value

Control

O controle de servidor a ser removido.

Exemplos

O exemplo de código a seguir usa o Remove método para excluir um controle filho do controle de myButton servidor. Primeiro, o código usa o Contains método para determinar se o myChildControl está contido no ControlCollection objeto e, se estiver, o remove.

// Use the Contains method to check whether
// a child control exists, and if it does,
// use the Remove method to delete it.        
if (myButton.Controls.Contains(myChildControl))
{
   myButton.Controls.Remove(myChildControl);
   msgRemove.Text = "You removed myLiteralControl.";
}
else msgRemove.Text="The control to remove does not exist." ;

' Use the Contains method to check whether
' a child control exists, and if it does,
' use the Remove method to delete it.        
If myButton.Controls.Contains(myChildControl)
   myButton.Controls.Remove(myChildControl)
   msgRemove.Text = "You removed myLiteralControl."
Else
   msgRemove.Text="The control to remove does not exist." 
End If

Comentários

Para remover um controle de um local de índice, use o RemoveAt método .

Confira também

• RemoveAt(Int32)
• Controls