DataGridViewCellCollection.AddRange(DataGridViewCell[]) Method

Definition

Adds an array of cells to the collection.

C#
public virtual void AddRange(params System.Windows.Forms.DataGridViewCell[] dataGridViewCells);

Parameters

dataGridViewCells
DataGridViewCell[]

The array of DataGridViewCell objects to add to the collection.

Exceptions

dataGridViewCells is null.

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

-or-

At least one value in dataGridViewCells is null.

-or-

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

-or-

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

Remarks

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.

Applies to

Product Versions
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

See also