DataGridViewColumnCollection.Remove Método

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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 -> unit
Public Overridable Sub Remove (columnName As String)

Parâmetros

columnName
String

O nome da coluna a ser excluída.

Exceções

ArgumentException

columnName não corresponde ao nome de nenhuma coluna na coleção.

ArgumentNullException

columnName é null.

InvalidOperationException

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 -> unit
Public Overridable Sub Remove (dataGridViewColumn As DataGridViewColumn)

Parâmetros

dataGridViewColumn
DataGridViewColumn

A coluna a ser excluída.

Exceções

ArgumentException

dataGridViewColumn não está na coleção.

ArgumentNullException

dataGridViewColumn é null.

InvalidOperationException

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.

Confira também

Aplica-se a