DataGridViewCellCollection.AddRange(DataGridViewCell[]) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.