Expand Minimize

DataGridView::SelectedCells Property

Gets the collection of cells selected by the user.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

[BrowsableAttribute(false)]
public:
property DataGridViewSelectedCellCollection^ SelectedCells {
	DataGridViewSelectedCellCollection^ get ();
}

Property Value

Type: System.Windows.Forms::DataGridViewSelectedCellCollection
A DataGridViewSelectedCellCollection that represents the cells selected by the user.

The SelectedCells property is always populated regardless of the SelectionMode property value.

This property contains a read-only snapshot of the selection at the time it is referenced. If you hold onto a copy of this collection, it may differ from the actual, subsequent DataGridView state in which the user may have changed the selection. Therefore, you should not operate on a copy of the collection.

The following code example demonstrates how to use the SelectedCells collection to find the sum of the values in the selection. In the example, this collection is iterated through and the valid values are added to the sum, which is displayed in a label. This example is part of a larger example available in the SelectionChanged event.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft