Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Método Control.ControlCollection.Clear

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ções

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.

Observação importanteImportante

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

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

Observações para herdeiros

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

O exemplo de código a seguir remove todos os Control objetos na 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

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft