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
Esta documentação foi arquivada e não está sendo atualizada.

Método DataGridViewColumnCollection.Remove (String)

Remove a coluna com o nome especificado da coleção.

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

public virtual void Remove(
	string columnName
)

Parâmetros

columnName
Tipo: System.String
O nome da coluna para excluir.

ExceçãoCondição
ArgumentException

columnName não é compatível com o nome de qualquer coluna na coleção.

ArgumentNullException

columnName é null.

InvalidOperationException

O associado DataGridView controle está executando uma das ações a seguintes, que impede temporariamente as novas colunas sejam adicionados:

  • Selecionar todas as células no controle.

  • Limpando a seleção.

  • Atualizar a coluna DisplayIndex valores de propriedade.

- ou -

Esse método é chamado de um manipulador para um da seguir DataGridView eventos:

O nome de uma coluna é indicado pelo DataGridViewColumn.Name propriedade.

Para remover uma coluna que é gerada automaticamente ao ligar a uma fonte de dados, chamar este método em um DataGridView.DataBindingComplete manipulador de eventos.

O exemplo de código a seguir ilustra o uso desse método.Para obter mais informações, consulte Como: Remover colunas gerada automaticamente de um Controlarar Exibição em Grade de Dados do Windows Forms.

privatevoid BindDataAndInitializeColumns()
{
    dataGridView1.AutoGenerateColumns = true;
    dataGridView1.DataSource = customersDataSet;
    dataGridView1.Columns.Remove("Fax");
    dataGridView1.Columns["CustomerID"].Visible = false;
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0
Mostrar: