DataGridView添加CheckBox列需手动创建并禁用AutoGenerateColumns，绑定bool属性时确保DataPropertyName匹配、启用CommitEdit提交编辑，并通过遍历DataBoundItem获取选中项。
DataGridView 添加 CheckBox 列必须手动创建，不能靠 AutoGenerateColumns
许多C#开发者在初次为DataGridView添加复选框列时都会遇到一个典型问题：数据源中明明定义了布尔（bool）类型字段，但绑定后表格中显示的却是“True”或“False”文本，而非可交互的复选框控件。
其根本原因在于DataGridView的默认行为。当AutoGenerateColumns属性设置为true（默认值）时，控件会自动根据数据源类型生成列，但对于布尔字段，它只会生成一个只读的文本列。要实现可勾选的复选框列，必须禁用自动生成功能，并手动创建DataGridViewCheckBoxColumn。
以下是实现复选框列的标准步骤：
dataGridView1.AutoGenerateColumns = false;
var checkBoxCol = new DataGridViewCheckBoxColumn
{
Name = "Select",
HeaderText = "选择",
DataPropertyName = "IsSelected", // 必须和数据源属性名一致
Width = 50,
ThreeState = false // 通常不需要三态，设为 false 更符合多选预期
};
dataGridView1.Columns.Add(checkBoxCol);
- 若数据源为
List这类集合，请确保MyItem类中包含一个可读写的公共布尔属性，例如public bool IsSelected { get; set; }。 DataPropertyName属性是连接界面与数据的关键，其值必须与数据源中的属性名称（包括大小写）完全匹配。若名称不一致，复选框将显示为灰色不可用状态。- 手动添加列后，需重新绑定数据源以生效：
dataGridView1.DataSource = dataList;。
点击复选框不触发事件？需调用CommitEdit提交编辑
解决了显示问题后，下一个常见难点是数据同步。用户勾选复选框后，为何绑定的数据源值没有立即更新？在遍历集合时看到的仍是旧状态。
这是因为DataGridView中CheckBox单元格的值变更默认不会立即提交到数据绑定源。诸如CurrentCellDirtyStateChanged和CellValueChanged等事件不会在点击时自动触发更新。
解决方案是在适当的事件中手动调用CommitEdit方法，将界面上的编辑状态提交至底层数据源。
private void dataGridView1_CurrentCellDirtyStateChanged(object sender, EventArgs e)
{
if (dataGridView1.IsCurrentCellDirty && dataGridView1.CurrentCell is DataGridViewCheckBoxCell)
{
dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit);
}
}
- 首先，需要订阅
CurrentCellDirtyStateChanged事件：dataGridView1.CurrentCellDirtyStateChanged += ...。 - 若省略
CommitEdit步骤，后续通过遍历DataSource获取选中状态的操作将读取到过时数据。 - 注意：不应在
CellValueChanged事件中处理此逻辑，因为此时新值可能尚未写入底层数据对象。
实现全选/反选功能：应操作数据源而非直接修改单元格
为DataGridView实现“全选”或“反选”是常见需求。但需注意一个陷阱：直接遍历dataGridView1.Rows并修改每个复选框单元格的Value属性，虽然界面会更新，但极易导致界面显示与数据源不同步，尤其是在使用BindingList或BindingSource等支持变更通知的组件时。
更可靠的方法是直接操作数据集合本身，利用数据绑定机制自动更新界面。
var bindingSource = dataGridView1.DataSource as BindingSource;
if (bindingSource?.List is IList list)
{
foreach (var item in list)
{
var prop = item.GetType().GetProperty("IsSelected");
prop?.SetValue(item, true); // 或 false
}
}
// 触发界面刷新（如果没启用自动通知，需手动 ResetBindings）
bindingSource?.ResetBindings(false);
- 若数据源为普通
List，修改集合后需重新绑定以刷新界面：dataGridView1.DataSource = null; dataGridView1.DataSource = dataList;。 - 对于需要频繁进行批量操作的场景，建议使用实现了
INotifyPropertyChanged接口的BindingList作为数据源，虽然初期编码量稍大，但能确保数据同步的健壮性。 - 务必避免直接使用
Rows[i].Cells[j].Value = true方式进行批量设置，因为它绕过了数据绑定，在下次数据刷新时修改可能被覆盖。
获取所有选中行：应遍历DataBoundItem而非依赖SelectedRows
这是一个容易混淆的概念。DataGridView的SelectedRows属性指的是用户通过鼠标或键盘高亮选中的行（整行背景色变化），这与复选框的选中状态是完全独立的两套系统。试图用SelectedRows.Count来统计被勾选的行数，结果必然是错误的。
要准确获取“复选框被勾选的行”，必须遍历所有行，并检查对应复选框列的值。
var selectedItems = new List(); foreach (DataGridViewRow row in dataGridView1.Rows) { if (row.Cells["Select"].Value is bool b && b) { // 注意：DataBoundItem 可能为 null（比如新增未提交的行） if (row.DataBoundItem is MyItem item) { selectedItems.Add(item); } } }
- 关键步骤：始终检查
row.DataBoundItem是否为null。对于允许用户添加新行的表格（AllowUserToAddRows = true），最后一行用于新增的空行其DataBoundItem为null，不判断会导致NullReferenceException。 - 通过索引访问单元格时，建议使用列的名称（如
"Select"）而非数字索引（如[0]）。这样即使调整了列的显示顺序，代码也不会出错。 - 再次提醒：若启用了
AllowUserToAddRows，遍历时需特别注意最后那行用于新增的空行。
在实际C# WinForms开发中，还有一些细节需留意：例如，复选框列的ReadOnly属性默认为false，但如果数据源对应的属性没有public的setter访问器，运行时复选框将无法点击。又如，在窗体构造函数中过早绑定数据源，而列尚未初始化完成，会导致绑定失败。这些情况通常不会抛出明显异常，但行为会非常诡异。因此，最佳实践是逐一检查数据绑定配置与数据对象契约是否严格对齐，确保DataGridView复选框功能稳定可靠。
