ControlCollection.Remove(Control) Método

Definição

Remove o controlo do servidor especificado do objeto do controlo ControlCollection do 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 controlo do servidor será removido.

Exemplos

O exemplo de código seguinte utiliza o Remove método para eliminar um controlo filho do myButton controlo do servidor. Primeiro, o código usa o Contains método para determinar se o myChildControl está contido no ControlCollection objeto e, se estiver, remove-o.

// 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

Observações

Para remover um controlo de uma localização de índice, use o RemoveAt método.

Aplica-se a

Ver também