Control.ControlCollection.Clear Método

public:
 virtual void Clear();

public virtual void Clear();

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

Public Overridable Sub Clear ()

Implementações

Exemplos

O seguinte exemplo de código remove todos os Control objetos em da Control.ControlCollection classe Panelderivada . O exemplo exige que tenhas criado um Panel, um Button, e pelo menos outro controlo sobre um Form. Os outros controlos são adicionados ao Panel controlo, e os Panel adicionados ao Form. Quando o botão é pressionado, todos os controlos 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

Observações

Pode usar o Clear método para remover toda a coleção de controlos de um controlo parental.

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

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

Notas para Herdeiros

Ao substituir Clear() uma classe derivada, certifique-se de chamar o método da Clear() classe base para garantir que todos os controlos são removidos da coleção.