简介面向 Windows Forms 初学者的 DataGridView 直接修改数据示例重点演示在 C# 中启用单元格编辑、通过编辑结束事件把改动同步回数据源、使用验证事件拦截非法输入并为日期列接入自定义日期选择控件同时涵盖行增删、异常提示等交互细节完整覆盖表格就地编辑的常见开发场景。压缩包以可直接运行工程形式交付共 28 个文件约 53KB内含 9 个 C# 源码文件及窗体设计器与资源文件另有工程配置、可执行程序和调试符号结构小巧便于对照学习、课设复用或迁移到实际项目。已有 918 人学习下载。源码对编辑模式、结束编辑后提交、单元格验证与取消编辑机制、日期控件的样式设置等关键点均给出示例并附界面提示与异常处理思路可帮助开发者快速掌握表格就地编辑的常用模式、验证流程与数据源同步方法。1. DataGridView 直接修改数据别让表格停留在只读展示阶段做 WinForms 桌面开发的工程师十有八九遇到过这种需求界面上一个 DataGridView绑了一堆数据用户说要能点进去改改完要能存回去。数据量不大犯不着上复杂框架但你真去做的时候会发现——DataGridView 默认行为、编辑事件、数据源同步这几块配合不好要么改了界面上没变要么数据源纹丝不动要么验证逻辑把人卡死在单元格里。这个资源把「直接修改数据」这条链路完整拆开了编辑模式设置、CellValidating 输入验证、EndEdit 提交、自定义编辑控件以及把 List 里的 0/1 值渲染成 CheckBox 的玩法适合正在维护 WinForms 老项目或者新项目里要用表格编辑的开发者照着敲一遍就能避开我当年踩过的坑。2. 把编辑模式和数据源绑定先理顺EditMode 与 DataPropertyName 的配合2.1 数据源决定编辑行为DataTable 和 List 的同步差异直接用 DataGridView 编辑数据第一件事不是写代码而是想清楚绑的是什么数据源。这个资源的工程里Form1.cs 中绑定的数据源直接决定了编辑后要不要手动同步。我拆过不少项目最常见的绑定方式有两种// 方式一绑定 DataTableDataGridView 编辑后自动同步到 DataTable DataTable dt new DataTable(); dt.Columns.Add(Id, typeof(int)); dt.Columns.Add(Name, typeof(string)); dt.Columns.Add(Quantity, typeof(int)); dt.Rows.Add(1, 螺丝, 100); dt.Rows.Add(2, 垫片, 200); dataGridView1.DataSource dt; // 方式二绑定 ListT改动不会自动回写到对象 ListProduct products new ListProduct { new Product { Id 1, Name 螺丝, Quantity 100 }, new Product { Id 2, Name 垫片, Quantity 200 } }; dataGridView1.DataSource products;这里有个关键差异绑定 DataTable 时DataGridView 编辑单元格本质上是直接改 DataTable 里那一行那一列的值因为 DataTable 自身就支持行状态跟踪AcceptChanges()之前你可以随时判断哪些行被改过。绑定 List 就麻烦一些DataGridView 只把 List 当作只读数据源来渲染单元格编辑完成之后对象本身不会被更新。我一般会这么做判断如果编辑场景是临时表格、改完批量提交用 DataTable 最省心如果数据模型是业务对象且改动要触发后续业务逻辑那建议用BindingListT配合对象实现INotifyPropertyChanged或者干脆在事件里手动同步。这个资源里给的思路是后者——在CellEndEdit里自己写同步逻辑这种做法控制力强但要注意别漏了行。2.2 EditMode 的四个取值默认行为不是点一下就改很多新手上来就卡在第一步为什么我单击单元格数据没变成可编辑状态因为 DataGridView 的默认EditMode是EditOnKeystrokeOrF2也就是要按键或者按 F2 才进入编辑。你要是想做到单击就进编辑必须显式设置。资源里的代码给的是EditOnEnterdataGridView1.EditMode DataGridViewEditMode.EditOnEnter;这个枚举一共有五个值我整理了一下实际项目里怎么选EditMode 值进入编辑的方式适用场景EditOnEnter单击单元格立即进入编辑纯编辑型表格不需要选中行做操作EditOnF2按 F2 才进入编辑兼顾浏览和编辑防止误改EditOnKeystroke输入字符时进入编辑快速录入场景类似 ExcelEditOnKeystrokeOrF2输入字符或按 F2 进入编辑DataGridView 默认值最保守EditProgrammatically只能通过BeginEdit()进入编辑完全由代码控制编辑时机实际经验是如果表格里还有选中整行、右键菜单、拖拽这类交互EditOnEnter会让人抓狂——你刚点一下行还没选中呢单元格先进入编辑状态了行选择逻辑全乱套。这时候用EditOnF2或者EditOnKeystroke更顺手。这个资源的工程里用的EditOnEnter适合它那种点击即改的简单场景你要是做复杂表格这个设置要慎重。2.3 列映射与提交时机DataPropertyName 和 EndEdit 的关系数据源绑定好了编辑模式也设了接下来要处理两个坑列怎么对应字段以及什么时候把界面上的改动真正提交。// 关闭自动生成列手动控制每一列绑定哪个字段 dataGridView1.AutoGenerateColumns false; DataGridViewTextBoxColumn colName new DataGridViewTextBoxColumn(); colName.DataPropertyName Name; colName.HeaderText 名称; dataGridView1.Columns.Add(colName); DataGridViewTextBoxColumn colQty new DataGridViewTextBoxColumn(); colQty.DataPropertyName Quantity; colQty.HeaderText 数量; dataGridView1.Columns.Add(colQty);DataPropertyName是 DataGridView 列和数据源字段之间的映射桥梁。如果不设置列会显示对象类型的全名如果设置了但字段名拼错整列就是空的。所以我建议在绑定数据源之前先把列结构定义好开着AutoGenerateColumns false写死映射关系这样同事接手维护时一眼能看懂每列是什么。至于提交时机资源里CellEndEdit事件里做同步是一种方式但这里有一个更隐蔽的问题单元格编辑器关闭时改动未必已经提交到数据源。特别是绑定了 DataTable 时如果当前行还处于编辑状态就切走了CellEndEdit拿到了Value可能是旧值。标准的做法是在CurrentCellDirtyStateChanged事件里手动提交private void dataGridView1_CurrentCellDirtyStateChanged(object sender, EventArgs e) { if (dataGridView1.IsCurrentCellDirty) { // CommitEdit 会把单元格的改动以编程方式提交触发 CellEndEdit dataGridView1.CommitEdit(DataGridViewDataErrorContexts.Commit); } }CommitEdit的参数DataGridViewDataErrorContexts.Commit告诉控件这是正常提交而不是错误恢复提交之后CellEndEdit再触发此时拿到的Value就是可靠的新值。我见过太多项目不在这个时机提交结果数据源里一直是旧值查了半天发现是提交时序的玄学问题。记住这句话界面上的值不等于数据源里的值中间隔着一层脏状态。3. 编辑事件链CellValidating 验证、EndEdit 提交与自定义编辑控件3.1 事件触发顺序决定了你的代码写在哪DataGridView 的编辑相关事件不是一个一个孤立存在的它有严格的触发顺序。我在这个资源的工程里梳理了一遍整个过程是这样的用户进入编辑 →CellBeginEdit触发此时适合记录原始值做变更对比。用户修改内容后试图离开单元格 →CellValidating触发此时还没真正提交你可以拦截并取消离开。验证通过后 →CellEndEdit触发单元格的编辑器关闭值写入行缓存。如果整行被提交 →RowValidating/RowValidated触发这时做行级校验。这个顺序直接决定了你的代码应该写在哪单个单元格格式对不对写在CellValidating整行联动逻辑比如数量变了金额跟着变写在CellEndEdit之后或者RowValidated。我见过有人把格式校验写进CellEndEdit结果发现验证不通过时值已经写进去了回滚比拦截麻烦得多——这就是没搞清楚事件顺序的后果。3.2 CellValidating 做输入验证拦截不能靠 MessageBox 硬撑资源里给的CellValidating验证代码如下private void dataGridView1_CellValidating(object sender, DataGridViewCellValidatingEventArgs e) { // 只校验数量这一列列索引按你自己的实际情况调整 if (dataGridView1.Columns[e.ColumnIndex].Name Quantity) { if (!int.TryParse(e.FormattedValue.ToString(), out int result)) { MessageBox.Show(请输入有效的数字); e.Cancel true; // 取消编辑防止非法数据保存 } } }这里有一个参数要特别注意e.FormattedValue是用户在界面上看到的格式化文本不是e.Value。比如一个数字列设置了DefaultCellStyle.Format N2用户输入 100FormattedValue可能带千分位或小数格式。用e.FormattedValue做校验的好处是校验用户实际看到的输入但要注意格式化和解析的互逆关系——你格式化成了N2解析时就要能接受千分位。还要注意MessageBox.Show在CellValidating里的副作用弹窗会抢走焦点用户关掉弹窗后焦点可能不在原单元格上导致CellValidating再次触发形成弹窗 → 再次校验 → 再弹窗的死循环。我踩过一次这个坑后来改成了StatusStrip显示错误提示或者先e.Cancel true再弹窗弹窗里只提示不干扰焦点。资源里的写法在小项目里没问题但你做生产级工具时建议把弹窗换成非模态提示。3.3 给日期列挂 DateTimePickerEditingControlShowing 的正确用法资源里给了自定义编辑控件的思路日期列用DateTimePicker替换默认文本框。真正落地时要用到EditingControlShowing事件private void dataGridView1_EditingControlShowing(object sender, DataGridViewEditingControlShowingEventArgs e) { // 只在日期列挂载 DateTimePicker if (dataGridView1.CurrentCell.ColumnIndex dataGridView1.Columns[DateColumn].Index) { DateTimePicker picker e.Control as DateTimePicker; if (picker ! null) { picker.Format DateTimePickerFormat.Custom; picker.CustomFormat yyyy-MM-dd; // 把当前单元格的值塞给 picker否则显示的默认日期是今天 picker.Value Convert.ToDateTime(dataGridView1.CurrentCell.Value); } } }这段代码的关键点有两个一是e.Control在列类型是DataGridViewTextBoxColumn时默认是DataGridViewTextBoxEditingControl并不会自动变成DateTimePicker。要真正生效你得把列的CellTemplate换掉或者更常见的做法是使用DataGridViewCalendarCell之类的自定义单元格这类类在一些开源库里能找到或者在EditingControlShowing里手动替换。实际项目中我常用的方案是定义一个继承DataGridViewTextBoxCell的日历单元格类重写EditType属性返回DateTimePickerEditingControl的类型这样 DataGridView 在进入编辑时就会自动用DateTimePicker做编辑器。资源里那段只设置了DefaultCellStyle.Format的代码只是让列以日期格式显示并没有真正改变编辑器这一点你动手做的时候别被误导。另外DefaultCellStyle.NullValue null这个设置要注意如果数据库里该列允许 NULL在CellValidating里要提前判断空值否则Convert.ToDateTime会把空字符串也转换失败直接抛异常导致编辑无法退出。4. 避坑手册DataGridView 编辑场景下我踩过的五个坑4.1 改完切行数据源里还是旧值现象界面上单元格的值明明改了切到别的行再切回来值恢复成原来的或者断点打到数据源的取值代码里发现数据根本没用。原因DataGridView 的单元格编辑器关闭分为值写入行缓存和提交到数据源两步。如果只改了界面没有触发CommitEdit或EndEdit改动就停留在编辑缓冲区里。尤其是绑定了DataTable时行缓存未提交DataTable里那行的RowVersion还是Original你取Current版本的值自然是旧值。解决在CurrentCellDirtyStateChanged里判断IsCurrentCellDirty然后调用CommitEdit(DataGridViewDataErrorContexts.Commit)。注意不要每次脏了都提交否则会引发频繁的CellEndEdit事件影响性能。4.2 CellValidating 里弹 MessageBox 导致编辑无法退出现象CellValidating里弹了MessageBox用户点确定后单元格一直处于编辑状态光标切不走甚至弹窗连续出现。原因原因是MessageBox.Show是模态的它会抢焦点并阻塞消息循环。用户关闭弹窗后DataGridView 尝试再次验证时e.FormattedValue还是非法值而焦点又被拉回了单元格于是CellValidating再次触发形成了循环校验。解决先设置e.Cancel true取消当前编辑把错误信息写到一个标签或者StatusStrip上引导用户重新输入。如果一定要用弹窗用BeginInvoke异步弹避免阻塞 DataGridView 的编辑状态机。private void dataGridView1_CellValidating(object sender, DataGridViewCellValidatingEventArgs e) { if (dataGridView1.Columns[e.ColumnIndex].Name Quantity !int.TryParse(e.FormattedValue.ToString(), out _)) { e.Cancel true; // 先取消再提示 this.BeginInvoke(new Action(() { MessageBox.Show(数量必须是整数); dataGridView1.BeginEdit(true); // 回到编辑状态 })); } }4.3 绑定了 List 改了界面但业务对象没变现象DataSource绑定的是ListProduct用户在界面上改了数量断点看product.Quantity还是原来的值。原因ListT是老生常谈的一个问题——IListT接口没有通知机制DataGridView 的编辑结果无法自动回写给对象。另外如果Product是值类型比如struct装箱拆箱过程中的改动全部丢失。解决方案有两个。要么用BindingListProduct替代ListProduct并且让Product实现INotifyPropertyChanged要么在CellEndEdit事件里手动从dataGridView1.Rows[e.RowIndex]取行数据再更新对应的Product对象。资源的工程里用的是手动同步适合简单场景但对象多了就容易漏我建议能上BindingList就上。4.4 自动生成列导致列顺序乱、多出不想显示的列现象绑定数据源后没关AutoGenerateColumns表格里冒出了Id、CreatedAt之类的列列顺序也和预期不一致。原因AutoGenerateColumns true时DataGridView 按数据源的属性反射顺序生成列你控制不了顺序也控制不了哪些字段显示。解决把AutoGenerateColumns设为false用代码显式添加列并设置DataPropertyName。这一步看着麻烦但能避免后续所有列映射问题。另外在资源包里那个Form1.Designer.cs文件里你应该能看到列定义都是手写的这就是一个值得沿用的习惯。4.5 CheckBox 列点一下不变点两下才起作用现象界面上有一列显示的是DataGridViewCheckBoxColumn用户点击复选框第一次没反应再点一次才变。原因第一次点击只是进入编辑模式第二次点击才是真正的状态切换。这本质上是编辑模式设置的问题和EditMode有关。解决如果是整列都是 CheckBox把DataGridViewCheckBoxColumn的ThreeState设为false并且在CellContentClick里直接切换值配合EndEdit提交。更细致的做法是用CurrentCellDirtyStateChanged在点击复选框后立刻提交让界面响应像真正的复选框。5. 进阶玩法把 List 里的 0/1 值渲染成 CheckBox 列数据库的tinyint字段经常用 0/1 表示开关状态但界面上你想让用户勾选复选框而不是输入 1 或 0。这个场景在热搜里也有人在问做法其实不复杂用DataGridViewCheckBoxColumn绑定然后在CellFormatting里把 0/1 转成bool在CellParsing里把bool转回 0/1。// 1. 先添加 CheckBox 列并绑定字段 DataGridViewCheckBoxColumn chkCol new DataGridViewCheckBoxColumn(); chkCol.DataPropertyName Enabled; chkCol.HeaderText 启用; dataGridView1.Columns.Add(chkCol); // 2. 显示时把 0/1 转成 true/false private void dataGridView1_CellFormatting(object sender, DataGridViewCellFormattingEventArgs e) { if (dataGridView1.Columns[e.ColumnIndex] is DataGridViewCheckBoxColumn) { if (e.Value ! null e.Value ! DBNull.Value) { // 兼容数据库返回 int 和字符串 0/1 e.Value Convert.ToInt32(e.Value) 1; e.FormattingApplied true; } } } // 3. 编辑完成时把 true/false 转回 0/1 private void dataGridView1_CellParsing(object sender, DataGridViewCellParsingEventArgs e) { if (dataGridView1.Columns[e.ColumnIndex] is DataGridViewCheckBoxColumn) { e.Value (bool)e.Value ? 1 : 0; e.ParsingApplied true; } }CellFormatting在单元格绘制时触发FormattingApplied true表示你已经处理了格式化DataGridView 不要再按默认方式转换CellParsing在编辑器关闭、值要写回数据源时触发ParsingApplied同理。这两个事件把界面显示和数据存储剥离开数据层该存 0/1 就存 0/1界面该显示复选框就显示复选框互不污染。如果你不写CellParsing那单元格里显示的True/False会被直接存回数据源数据库的tinyint字段就翻车了。还有一个细节复选框列默认的对齐方式是居中如果你希望表头也居中要单独设置HeaderCell.Style.Alignment DataGridViewContentAlignment.MiddleCenter。另外如果数据源里某个值是DBNullCellFormatting里一定要判空否则Convert.ToInt32(null)直接抛异常整个表格绘制都会崩。从那以后我每次做 DataGridView 的编辑功能都强制走一遍这条链路先定数据源类型决定同步方案再设EditMode决定交互方式接着列映射写死最后在CurrentCellDirtyStateChanged里提交更改、在CellValidating里做验证。这套流程虽然不能保证不踩坑但至少能让你踩坑时知道问题出在编辑链路的哪一环。希望帮到你。本文还有配套的精品资源点击获取