Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método Control.ControlCollection.Clear ()

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Remove todos os controles da coleção.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

public virtual void Clear()

Implementa

IList.Clear()

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 o Remove ou RemoveAt métodos.

System_CAPS_importantImportante

Chamar o Clear método não remove as alças de controle de memória. Você deve chamar explicitamente o Dispose perdas de método para evitar a memória.

Para adicionar uma nova Control objetos na coleção, use o Add ou AddRange métodos.

Observações para os Herdeiros:

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

O exemplo de código a seguir remove todos os Control objetos no Control.ControlCollection da classe derivada Panel. 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 o Panel adicionado para o Form. 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();
}

.NET Framework
Disponível desde 1.1
Retornar ao início
Mostrar: