DataGridViewCellCollection

Wisej.Web.DataGridViewCellCollection

Namespace: Wisej.Web

Assembly: Wisej.Framework (4.0.0.0)

• BaseCollection

  • DataGridViewCellCollection

Represents a collection of cells in a DataGridViewRow.

C#

public class DataGridViewCellCollection : BaseCollection, IList, IList<DataGridViewCell>, ICollection<DataGridViewCell>, IEnumerable<DataGridViewCell>

VB.NET

Public Class DataGridViewCellCollection
    Inherits BaseCollection
    Implements IList, IList(Of DataGridViewCell), ICollection(Of DataGridViewCell), IEnumerable(Of DataGridViewCell)

Constructors

DataGridViewCellCollection(row)

Initializes a new instance of the DataGridViewCellCollection class.

Name	Type	Description
row	DataGridViewRow	The DataGridViewRow that owns the collection.

Properties

Item(column)

DataGridViewCell: Returns or sets the cell contained in the specified column .

Throws:

• ArgumentNullException The specified value when setting this property is null; or column is null.

• InvalidOperationException The specified cell when setting this property already belongs to a DataGridView control, or the specified cell when setting this property already belongs to a DataGridViewRow

• ArgumentNullException column is null.

• ArgumentException The specified column does not belong to the same DataGridView that owns the cells.

• ArgumentOutOfRangeException The index of the specified column is less than 0 or is equal to or greater than the number of cells in the collection.

Item(index)

DataGridViewCell: Returns or sets the cell at the provided index location.

Throws:

• ArgumentNullException The specified value when setting this property is null.

• InvalidOperationException The specified cell when setting this property already belongs to a DataGridView control, or the specified cell when setting this property already belongs to a DataGridViewRow.

• ArgumentOutOfRangeException index is less than 0 or index is equal to or greater than the number of cells in the collection.

Item(columnName)

DataGridViewCell: Returns or sets the cell in the column with the provided name.

Throws:

• ArgumentException columnName does not match the name of any columns in the control.

• ArgumentNullException The specified value when setting this property is null; or columnName is null.

• InvalidOperationException The specified cell when setting this property already belongs to a DataGridView control, or the specified cell when setting this property already belongs to a DataGridViewRow.

List

IList: Returns the collection.

Methods

Add(cell)

Adds a cell to the collection.

Parameter	Type	Description
cell	DataGridViewCell	A DataGridViewCell to add to the collection.

Returns: Int32. The position in which to insert the new element.

Throws:

• InvalidOperationException The row that owns this DataGridViewCellCollection already belongs to a DataGridView control, or cell already belongs to a DataGridViewRow.

AddInternal(cell)

Parameter	Type	Description
cell	DataGridViewCell

Returns: Int32.

AddRange(cells)

Adds an array of cells to the collection.

Parameter	Type	Description
cells	DataGridViewCell[]	The array of DataGridViewCell objects to add to the collection.

Throws:

• ArgumentNullException cells is null.

• InvalidOperationException The row that owns this DataGridViewCellCollection already belongs to a DataGridView control, or at least one value in cells is null, or at least one cell in cells already belongs to a DataGridViewRow, or at least two values in cells are references to the same DataGridViewCell.

AddRangeInternal(cells)

Adds an array of cells to the collection.

Parameter	Type	Description
cells	DataGridViewCell[]	The array of DataGridViewCell objects to add to the collection.

Throws:

• ArgumentNullException cells is null.

• InvalidOperationException The row that owns this DataGridViewCellCollection already belongs to a DataGridView control, or at least one value in cells is null, or at least one cell in cells already belongs to a DataGridViewRow, or at least two values in cells are references to the same DataGridViewCell.

Clear()

Clears all cells from the collection.

Throws:

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

Contains(cell)

Determines whether the specified cell is contained in the collection.

Parameter	Type	Description
cell	DataGridViewCell	A DataGridViewCell to locate in the collection.

Returns: Boolean. true if cell is in the collection; otherwise, false.

CopyTo(array, index)

Copies the entire collection of cells into an array at a specified location within the array.

Parameter	Type	Description
array	DataGridViewCell[]	The destination array to which the contents will be copied.
index	Int32	The index of the element in array at which to start copying.

HasCell(index)

Returns whether the cell collection contains an instance of the DataGridViewCell class. This method is used by the framework to prevent the unnecessary creation of cells.

Parameter	Type	Description
index	Int32	The zero-based index of the cell to verify.

Returns: Boolean.

IndexOf(cell)

Returns the index of the specified cell.

Parameter	Type	Description
cell	DataGridViewCell	The cell to locate in the collection.

Returns: Int32. The zero-based index of the value of cell parameter, if it is found in the collection; otherwise, -1.

Insert(index, cell)

Inserts a cell into the collection at the specified index.

Parameter	Type	Description
index	Int32	The zero-based index at which to place cell .
cell	DataGridViewCell	The DataGridViewCell to insert.

Throws:

• InvalidOperationException The row that owns this DataGridViewCellCollection already belongs to a DataGridView control, or cell already belongs to a DataGridViewRow.

InsertInternal(index, cell)

Parameter	Type	Description
index	Int32
cell	DataGridViewCell

OnCollectionChanged(action, element)

Fires the CollectionChanged event.

Parameter	Type	Description
action	CollectionChangeAction	One of CollectionChangeAction indicating the reason the collection has changed.
element	Object	The element that was added or removed from the collection, or null.

Remove(cell)

Removes the specified cell from the collection.

Parameter	Type	Description
cell	DataGridViewCell	The DataGridViewCell to remove from the collection.

Throws:

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

• ArgumentException cell could not be found in the collection.

RemoveAt(index)

Removes the cell at the specified index.

Parameter	Type	Description
index	Int32	The zero-based index of the DataGridViewCell to be removed.

Throws:

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

RemoveAtInternal(index)

Parameter	Type	Description
index	Int32

Events

CollectionChanged

CollectionChangeEventHandler Fired when the collection changes.