Control.ControlCollection.Clear Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

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

Clear()

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.