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 -> unitPublic Overridable Sub Clear ()Implementaciones
Ejemplos
En el ejemplo de código siguiente se quitan todos los Control objetos de la Control.ControlCollection clase Panelderivada . El ejemplo requiere que haya creado un Panelcontrol , y Buttonal menos otro en .Form Los demás controles se agregan al Panel control y se Panel agregan 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
Al llamar al Clear método no se quitan 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.