DataGridViewColumnCollection.Remove Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Remove uma coluna da coleção.
Sobrecargas
| Remove(String) |
Remove a coluna com o nome especificado da coleção. |
| Remove(DataGridViewColumn) |
Remove a coluna especificada da coleção. |
Remove(String)
Remove a coluna com o nome especificado da coleção.
public:
virtual void Remove(System::String ^ columnName);public virtual void Remove (string columnName);abstract member Remove : string -> unit
override this.Remove : string -> unitPublic Overridable Sub Remove (columnName As String)Parâmetros
- columnName
- String
O nome da coluna a ser excluída.
Exceções
columnName não corresponde ao nome de nenhuma coluna na coleção.
columnName é null.
O controle DataGridView associado está executando uma das seguintes ações, que impedem temporariamente que novas colunas sejam adicionadas:
Selecionar todas as células no controle.
Limpar a seleção.
Atualizar os valores de propriedade DisplayIndex da coluna.
- ou -
Esse método está sendo chamado de um manipulador para um dos seguintes eventos DataGridView:
Exemplos
O exemplo de código a seguir ilustra o uso desse método. Para obter mais informações, consulte Como remover colunas geradas automaticamente de um controle Windows Forms DataGridView.
private void BindDataAndInitializeColumns()
{
dataGridView1.AutoGenerateColumns = true;
dataGridView1.DataSource = customersDataSet;
dataGridView1.Columns.Remove("Fax");
dataGridView1.Columns["CustomerID"].Visible = false;
}
Private Sub BindDataAndInitializeColumns()
With dataGridView1
.AutoGenerateColumns = True
.DataSource = customersDataSet
.Columns.Remove("Fax")
.Columns("CustomerID").Visible = False
End With
End Sub
Comentários
O nome de uma coluna é indicado pela DataGridViewColumn.Name propriedade .
Para remover uma coluna gerada automaticamente ao associar a uma fonte de dados, chame esse método em um DataGridView.DataBindingComplete manipulador de eventos.
Confira também
Aplica-se a
Remove(DataGridViewColumn)
Remove a coluna especificada da coleção.
public:
virtual void Remove(System::Windows::Forms::DataGridViewColumn ^ dataGridViewColumn);public virtual void Remove (System.Windows.Forms.DataGridViewColumn dataGridViewColumn);abstract member Remove : System.Windows.Forms.DataGridViewColumn -> unit
override this.Remove : System.Windows.Forms.DataGridViewColumn -> unitPublic Overridable Sub Remove (dataGridViewColumn As DataGridViewColumn)Parâmetros
- dataGridViewColumn
- DataGridViewColumn
A coluna a ser excluída.
Exceções
dataGridViewColumn não está na coleção.
dataGridViewColumn é null.
O controle DataGridView associado está executando uma das seguintes ações, que impedem temporariamente que novas colunas sejam adicionadas:
Selecionar todas as células no controle.
Limpar a seleção.
Atualizar os valores de propriedade DisplayIndex da coluna.
- ou -
Esse método está sendo chamado de um manipulador para um dos seguintes eventos DataGridView:
Comentários
Para remover uma coluna gerada automaticamente ao associar a uma fonte de dados, chame esse método em um DataGridView.DataBindingComplete manipulador de eventos.
