DataGridViewCellCollection.Add(DataGridViewCell) Method

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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 a cell to the collection.

public:
 virtual int Add(System::Windows::Forms::DataGridViewCell ^ dataGridViewCell);

public virtual int Add (System.Windows.Forms.DataGridViewCell dataGridViewCell);

abstract member Add : System.Windows.Forms.DataGridViewCell -> int
override this.Add : System.Windows.Forms.DataGridViewCell -> int

Public Overridable Function Add (dataGridViewCell As DataGridViewCell) As Integer

Parameters

dataGridViewCell: DataGridViewCell

A DataGridViewCell to add to the collection.

Returns

Int32

The position in which to insert the new element.

Exceptions

InvalidOperationException

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

-or-

dataGridViewCell already belongs to a DataGridViewRow.

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