Control.ControlCollection.Clear Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Quita todos los controles de la colección.
public:
virtual void Clear();
public virtual void Clear();
abstract member Clear : unit -> unit
override this.Clear : unit -> unit
Public Overridable Sub Clear ()
Implementaciones
Ejemplos
En el ejemplo de código siguiente se quitan todos los Control objetos Control.ControlCollection de la clase Panelderivada . En el ejemplo se requiere que haya creado un Panelcontrol , un Buttony al menos otro control en .Form Los demás controles se agregan al Panel control y el Panel agregado a Form. Cuando se hace clic en el botón, todos los controles contenidos en el panel se quitan de .Control.ControlCollection
// Clear all the controls in the Panel.
private:
void clearButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
panel1->Controls->Clear();
}
// Clear all the controls in the Panel.
private void clearButton_Click(object sender, System.EventArgs e)
{
panel1.Controls.Clear();
}
' Clear all the controls in the Panel.
Private Sub ClearButton_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles ClearButton.Click
Panel1.Controls.Clear()
End Sub
Comentarios
Puede usar el Clear método para quitar toda la colección de controles de un control primario.
Para quitar un control individual de la colección, use los Remove métodos o RemoveAt .
Importante
Llamar al Clear método no quita los identificadores de control de la memoria. Debe llamar explícitamente al Dispose método para evitar pérdidas de memoria.
Para agregar nuevos Control objetos a la colección, use los Add métodos o AddRange .
Notas a los desarrolladores de herederos
Al invalidar Clear() en una clase derivada, asegúrese de llamar al método de Clear() la clase base para asegurarse de que todos los controles se quitan de la colección.