DataGridView::CellValueNeeded Event
Occurs when the VirtualMode property of the DataGridView control is true and the DataGridView requires a value for a cell in order to format and display the cell.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Use this event in virtual mode to populate cells with data from a custom data store without causing rows to become unshared. For more information about row sharing, see Best Practices for Scaling the Windows Forms DataGridView Control. For more information about virtual mode, see Virtual Mode in the Windows Forms DataGridView Control.
To add user-specified values to your custom data store, handle the CellValuePushed event.
For more information about handling events, see NIB: Consuming Events.
The following code example handles the CellValueNeeded event to populate cells with positive integers. This example is part of a larger example available in the VirtualMode reference topic.
#pragma region Data store maintance
void VirtualConnector::dataGridView1_CellValueNeeded
(Object^ sender, DataGridViewCellValueEventArgs^ e)
{
if (store->ContainsKey(e->RowIndex))
{
// Use the store if the e value has been modified
// and stored.
e->Value = gcnew Int32(store->default[e->RowIndex]);
}
else if (newRowNeeded && e->RowIndex == numberOfRows)
{
if (dataGridView1->IsCurrentCellInEditMode)
{
e->Value = initialValue;
}
else
{
// Show a blank e if the cursor is just loitering
// over(the) last row.
e->Value = String::Empty;
}
}
else
{
e->Value = e->RowIndex;
}
}
void VirtualConnector::dataGridView1_CellValuePushed
(Object^ sender, DataGridViewCellValueEventArgs^ e)
{
String^ value = e->Value->ToString();
store[e->RowIndex] = Int32::Parse(value,
CultureInfo::CurrentCulture);
}
#pragma endregion
Available since 2.0
VirtualMode
DataGridViewCellValueEventHandler
DataGridViewCellValueEventArgs
CellValuePushed
OnCellValueNeeded
DataGridView Class
System.Windows.Forms Namespace
Best Practices for Scaling the Windows Forms DataGridView Control
Virtual Mode in the Windows Forms DataGridView Control
DataGridView Control (Windows Forms)