DataGridViewCellCollection.AddRange(DataGridViewCell[]) Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

DataGridViewCellCollection.cs

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

ArgumentNullException

dataGridViewCells is null.

InvalidOperationException

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.

See also

• DataGridView
• DataGridViewCell