C#怎么给DataGridView添加复选框_C#如何实现表格多选【案例】

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复选框功能稳定可靠。