DataGridViewCellCollection.AddRange Method (DataGridViewCell[])


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Adds an array of cells to the collection.

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

public virtual void AddRange(
	params DataGridViewCell[] dataGridViewCells


Type: System.Windows.Forms.DataGridViewCell[]

The array of DataGridViewCell objects to add to the collection.

Exception Condition

dataGridViewCells is null.


The row that owns this DataGridViewCellCollection already belongs to a DataGridView control.


At least one value in dataGridViewCells is null.


At least one cell in dataGridViewCells already belongs to a DataGridViewRow.


At least two values in dataGridViewCells are references to the same DataGridViewCell.

Use this method to populate a DataGridViewRow with cells before you add the row to a DataGridView control. Once you add the row to a control, the number of cells it contains always matches the number of columns in the control, so this method is no longer useful.

.NET Framework
Available since 2.0
Return to top