DataGridViewColumnCollection.Clear Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

DataGridViewColumnCollection.cs

Clears the collection.

public:
 virtual void Clear();

public virtual void Clear ();

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

Public Overridable Sub Clear ()

Exceptions

InvalidOperationException

The associated DataGridView control is performing one of the following actions that temporarily prevents new columns from being added:

• Selecting all cells in the control.

• Clearing the selection.

• Updating column DisplayIndex property values.

-or-

This method is being called from a handler for one of the following DataGridView events:

• CellEnter

• CellLeave

• CellValidating

• CellValidated

• RowEnter

• RowLeave

• RowValidated

• RowValidating

Examples

The following code example illustrates the use of this method. This example is part of a larger example available in Column Fill Mode in the Windows Forms DataGridView Control.

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

See also

• DataGridView
• DataGridViewColumn