ControlCollection.Remove(Control) Método

Definición

Quita el control de servidor especificado del objeto ControlCollection del control de servidor principal.Removes the specified server control from the parent server control's ControlCollection object.

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

Control de servidor que se va a quitar.The server control to be removed.

Ejemplos

En el ejemplo de código siguiente Remove se usa el método para eliminar un control secundario del myButton control de servidor.The following code example uses the Remove method to delete a child control from the myButton server control. En primer lugar, el código utiliza el Contains método para determinar si myChildControl está contenido en el ControlCollection objeto y, si es, lo quita.First the code uses the Contains method to determine whether the myChildControl is contained in the ControlCollection object, and, if it is, removes it.

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

Comentarios

Para quitar un control de una ubicación de índice, use el RemoveAt método.To remove a control from an index location, use the RemoveAt method.

Se aplica a

Consulte también