DataGridViewCellCollection.AddRange(DataGridViewCell[]) Method

Definition

Adds an array of cells to the collection.

public:
 virtual void AddRange(... cli::array <System::Windows::Forms::DataGridViewCell ^> ^ dataGridViewCells);
public virtual void AddRange (params System.Windows.Forms.DataGridViewCell[] dataGridViewCells);
abstract member AddRange : System.Windows.Forms.DataGridViewCell[] -> unit
override this.AddRange : System.Windows.Forms.DataGridViewCell[] -> unit
Public Overridable Sub AddRange (ParamArray dataGridViewCells As DataGridViewCell())

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

See also