DataGridViewColumnCollection.Clear Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Limpa a coleção.

public:
 virtual void Clear();

public virtual void Clear ();

abstract member Clear : unit -> unit
override this.Clear : unit -> unit

Public Overridable Sub Clear ()

Exceções

InvalidOperationException

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

• Selecionando todas as células no controle.

• Limpando a seleção.

• Atualizando os valores de propriedade DisplayIndex da coluna.

- ou - Esse método está sendo chamado de um manipulador para um dos seguintes eventos DataGridView:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

Exemplos

O exemplo de código a seguir ilustra o uso desse método. Este exemplo faz parte de um exemplo maior disponível no Modo de Preenchimento de Coluna no controle Windows Forms DataGridView.

private void ResetDataGridView()
{
    dataGridView1.CancelEdit();
    dataGridView1.Columns.Clear();
    dataGridView1.DataSource = null;
    InitializeDataGridView();
}

Private Sub ResetDataGridView()
    dataGridView1.CancelEdit()
    dataGridView1.Columns.Clear()
    dataGridView1.DataSource = Nothing
    InitializeDataGridView()
End Sub

Confira também

• DataGridView
• DataGridViewColumn