DataGridViewRow.CreateCells Method (DataGridView, Object[])


Clears the existing cells and sets their template and values.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public void CreateCells(
	DataGridView dataGridView,
	params object[] values


Type: System.Windows.Forms.DataGridView

A DataGridView that acts as a template for cell styles.

Type: System.Object[]

An array of objects that initialize the reset cells.

Exception Condition

Either of the parameters is null.


A row that already belongs to the DataGridView was added.


A column that has no cell template was added.

This method clears the row's DataGridViewCellCollection and reinitializes it with the CellTemplate property of each column of the dataGridView parameter. As a result, the row adopts the appearance and behavior of a row from the dataGridView parameter.

If there are more elements in the values array than cells to be initialized, the extra elements will be ignored. If there are fewer elements than required, the remaining unmatched cells will retain their default initial values.

.NET Framework
Available since 2.0
Return to top