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
| Nome | Description |
|---|---|
| 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 associado DataGridView está executando uma das seguintes ações que impede temporariamente que novas colunas sejam adicionadas:
Selecionando todas as células no controle.
Desmarcando a seleção.
Atualizando valores de propriedade da coluna DisplayIndex .
- ou -
Esse método está sendo chamado de um manipulador para um dos seguintes DataGridView eventos:
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 DataGridView do Windows Forms.
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 associado DataGridView está executando uma das seguintes ações que impede temporariamente que novas colunas sejam adicionadas:
Selecionando todas as células no controle.
Desmarcando a seleção.
Atualizando valores de propriedade da coluna DisplayIndex .
- ou -
Esse método está sendo chamado de um manipulador para um dos seguintes DataGridView eventos:
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.
