Control.ControlCollection.Clear Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Remove todos os controles da coleção.

public:
 virtual void Clear();

public virtual void Clear ();

abstract member Clear : unit -> unit
override this.Clear : unit -> unit

Public Overridable Sub Clear ()

Implementações

Clear()

Exemplos

O exemplo de código a Control.ControlCollection seguir remove todos os Control objetos na classe Panelderivada. O exemplo requer que você tenha criado um Panel, um Buttone pelo menos um outro controle em um Form. Os outros controles são adicionados ao Panel controle e adicionados Panel Formao . Quando o botão é clicado, todos os controles contidos no painel são removidos do 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

Comentários

Você pode usar o Clear método para remover toda a coleção de controles de um controle pai.

Para remover um controle individual da coleção, use os métodos ou RemoveAt os Remove métodos.

Importante

Chamar o Clear método não remove identificadores de controle da memória. Você deve chamar explicitamente o Dispose método para evitar vazamentos de memória.

Para adicionar novos Control objetos à coleção, use os métodos ou AddRange os Add métodos.

Notas aos Herdeiros

Ao substituir Clear() em uma classe derivada, chame o método da Clear() classe base para garantir que todos os controles sejam removidos da coleção.