DevExpress GridView 格式化数据：用 ValidatingEditor 随时验证输入合法性

1. 为什么 GridView 的输入校验总在“事后”才报错做 WinForms 业务系统的人大概率都遇到过这个场景用户在 DevExpress GridView 里录入“合格数量”“单价”“折扣率”这类格式化数据光标一离开单元格程序才弹一个 MessageBox 说“数据不合法”。用户已经点了下一行甚至已经点了保存这时候再回滚体验非常割裂。问题的根源在于很多人把校验逻辑写在了 CellValueChanged、RowUpdated 或者保存按钮里。这些时机都属于“事后校验”——值已经写进数据源了你再去判断只能靠手动回滚代码又臭又长。而 DevExpress 的 GridView 其实提供了一个专门在“提交前”拦截的入口就是 ValidatingEditor 事件。它在编辑器准备把值写回单元格之前触发你可以在这一刻决定这个值到底让不让它进去。这篇就围绕 DevExpress GridView 格式化数据的即时校验来写核心是 ValidatingEditor 事件的可复制配置骨架。适合正在用 DevExpress WinForms 做 ERP、MES、进销存这类录入界面的开发者。读完你能拿到一套能直接贴进项目的校验规则绑定方式、错误提示写法以及值不合法时如何让编辑器保持焦点、不污染数据源的完整逻辑。我试过把校验全塞进保存按钮结果就是用户填了 20 行保存时一次性弹 20 个错根本不知道先改哪个。ValidatingEditor 的价值就在于把错误拦在录入的当下。2. TaoToken 在开发调试链路里的位置写这类校验逻辑时经常需要查 DevExpress 某个事件的参数含义、某个属性的默认行为或者让模型帮你把一段校验规则改写成可配置的字典结构。这时候一个稳定的模型调用入口会省不少事。TaoToken 提供的就是这样一个统一入口官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它本身不替代 Visual Studio也不替代 DevExpress 控件库定位是你在写代码、查文档、让模型辅助生成校验骨架时的一个调用通道。你可以把它理解成本地该装的 DevExpress 照装该写的 C# 照写只是在需要模型帮你解释事件参数、生成规则表、排查报错的时候通过 TaoToken 的接口去调用。如果你只是偶尔问一句用模型对话就够了入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。如果你在长期做这类桌面端项目需要反复让模型参与编码可以看 Coding Plan地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。密钥管理在 console地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 具体创建 Key 在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入文档在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。需要说清楚的是TaoToken 是正常的 API 调用服务不是什么绕过限制的通道也不涉及任何网络访问方式的改变。你本地网络该怎么连 DevExpress 官网、怎么连 NuGet还是怎么连。3. ValidatingEditor 的可复制配置骨架3.1 事件绑定与基础签名ValidatingEditor 是 GridView 级别的事件签名固定参数类型是 BaseContainerValidateEditorEventArgs。绑定方式有两种设计器里双击事件或者代码里挂// 在窗体构造函数或 Load 事件里绑定 gvList.ValidatingEditor GvList_ValidatingEditor; private void GvList_ValidatingEditor(object sender, DevExpress.XtraEditors.Controls.BaseContainerValidateEditorEventArgs e) { // e.Value 是编辑器当前待提交的值 // e.Valid 默认 true设为 false 即拦截 // e.ErrorText 是拦截时显示的错误提示 }这里有个关键点e.Value 的类型取决于列编辑器的类型。如果列是 TextEdite.Value 是 object实际可能是 string如果是 SpinEdit可能是 decimal。所以第一步永远是先做类型归一化别直接 ToString 就完事。3.2 用 FieldName 做规则分发最直观的写法是按 FocusedColumn.FieldName 分发。下面这段是可直接复制的骨架把校验规则集中在一个 switch 里private void GvList_ValidatingEditor(object sender, DevExpress.XtraEditors.Controls.BaseContainerValidateEditorEventArgs e) { var view sender as DevExpress.XtraGrid.Views.Grid.GridView; if (view null) return; string field view.FocusedColumn?.FieldName; if (string.IsNullOrEmpty(field)) return; string raw e.Value null ? string.Empty : e.Value.ToString().Trim(); switch (field) { case passQty: ValidatePassQty(view, raw, e); break; case price: ValidatePrice(raw, e); break; case discount: ValidateDiscount(raw, e); break; default: break; } }这样写的好处是新增一个需要校验的列只加一个 case 和一个方法不用动主流程。3.3 合格数量校验跨行取值与边界判断合格数量这个字段的难点在于它的上限依赖同一行另一个字段 qty接货数量。所以校验时要从数据源里把当前行的 qty 取出来private void ValidatePassQty(DevExpress.XtraGrid.Views.Grid.GridView view, string raw, DevExpress.XtraEditors.Controls.BaseContainerValidateEditorEventArgs e) { int passQty; if (!int.TryParse(raw, out passQty)) { e.Valid false; e.ErrorText 合格数量必须是整数。; return; } if (passQty 0) { e.Valid false; e.ErrorText 合格数量不能为负数。; return; } // 从当前行数据源取接货数量 var row view.GetRow(view.FocusedRowHandle) as OrderDetail; if (row null) return; if (passQty row.qty) { e.Valid false; e.ErrorText string.Format(合格数量不能超过接货数量 {0}。, row.qty); } }注意这里用 int.TryParse 而不是 int.Parse避免用户输入“12a”这种直接抛异常。异常一旦抛出GridView 的默认行为可能直接把编辑器关掉体验更差。3.4 错误提示与焦点保持只设 e.Valid false 还不够。默认情况下DevExpress 会弹一个错误提示但焦点可能已经移走。要让用户必须改完才能离开需要配合 InvalidValueException 或者设置 View 的 OptionsBehavior// 在窗体初始化时设置 gvList.OptionsBehavior.AllowIncrementalSearch false; gvList.OptionsView.ShowErrorPanel DevExpress.Utils.DefaultBoolean.True;ShowErrorPanel 打开后错误提示会显示在编辑器下方而不是弹窗用户改的时候提示一直在改对了自动消失。这比 MessageBox 友好得多。如果你希望错误时焦点不离开当前单元格可以在 ValidatingEditor 里配合 view.FocusedColumn 和 view.ShowEditor但更稳妥的做法是依赖 DevExpress 自身的 Validating 机制——只要 e.Valid false编辑器默认不会提交焦点会留在原地。3.5 回滚逻辑值不合法时数据源不能被污染ValidatingEditor 最大的优势就是e.Valid false 时值根本不会写回数据源。所以你不需要写任何回滚代码。这一点和 CellValueChanged 完全不同——后者触发时值已经进去了你得手动 row.qty oldValue。但有一种情况要注意如果列绑定的不是简单属性而是通过 CustomUnboundColumnData 提供的非绑定列那 ValidatingEditor 拦截后数据源本来就没变也不需要回滚。真正需要小心的是在 ValidatingEditor 里做了副作用操作比如改了别的行的值。校验方法里只做判断不做写入这是原则。4. 验证请求与成功结果4.1 用模型辅助生成规则表如果你有十几个字段要校验手写 switch 会很啰嗦。可以让模型帮你把规则整理成字典结构再驱动校验。通过 TaoToken 的模型对话入口 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 可以问类似“把下面这些字段校验规则整理成 C# 字典key 是 FieldNamevalue 是校验委托”的问题。拿到建议后本地整理成这样的结构private static readonly Dictionarystring, ActionGridView, string, BaseContainerValidateEditorEventArgs Rules new Dictionarystring, ActionGridView, string, BaseContainerValidateEditorEventArgs { { passQty, ValidatePassQty }, { price, ValidatePrice }, { discount, ValidateDiscount }, };主事件里就变成一行分发ActionGridView, string, BaseContainerValidateEditorEventArgs rule; if (Rules.TryGetValue(field, out rule)) { rule(view, raw, e); }4.2 运行结果说明配置完成后实际运行时的表现是用户在 passQty 列输入“abc”按 Tab 或回车编辑器下方出现红字“合格数量必须是整数”焦点留在单元格数据源里该行 passQty 仍是旧值。输入“999”而接货数量是 100提示“合格数量不能超过接货数量 100”。输入“50”提示消失值正常提交。这个过程中保存按钮拿到的数据永远是合法的不需要在保存时再做一次全量校验。这就是把校验前移到 ValidatingEditor 的核心收益。5. 本篇常见错排查5.1 事件不触发最常见的原因是绑定写在了错误的 View 上。一个 GridControl 可能有多个 GridView主视图、明细视图ValidatingEditor 要绑在你实际编辑的那个 View 上。另外如果列的 ColumnEdit 被设成了某个自定义编辑器且 ReadOnly true事件也不会触发。5.2 e.Value 类型和预期不符比如你期望 e.Value 是 int结果拿到的是 string。这是因为编辑器类型决定的。TextEdit 给的就是 stringSpinEdit 给的是 decimal。统一用 ToString().Trim() 再 TryParse能规避大部分类型问题。5.3 错误提示不显示检查 OptionsView.ShowErrorPanel 是否设为 True。如果用的是 MessageBox 方式确认 e.ErrorText 不为空。另外如果 e.Valid 设了 false 但 ErrorText 是空字符串DevExpress 可能不显示任何提示用户会以为程序卡住了。5.4 跨行取值取到 nullview.GetRow(view.FocusedRowHandle) 在新增行NewItemRow场景下可能返回 null因为新行还没进数据源。这时候要么跳过跨行校验要么从 view.GetRowCellValue 取默认值。建议在校验方法开头加 null 判断直接 return让新行先通过等行提交后再校验。5.5 校验通过但值没保存如果列是 Unbound 类型ValidatingEditor 通过后值不会自动进数据源需要在 CustomUnboundColumnData 的 set 分支里手动写。这是另一个话题但排查时容易误以为是 ValidatingEditor 没生效。6. 后续怎么把这套骨架用顺把校验规则从事件里抽成独立方法再抽成字典最后你会发现新增字段校验只是加一行配置。这套结构在 DevExpress GridView 格式化数据场景里很耐用。如果你在接入模型辅助生成规则时遇到接口报错可以先看接入文档 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 密钥问题去 API Keys 页面 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 确认。长期做桌面端编码的话Coding Plan https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 会比单次对话更顺手。真正让校验稳定的不是规则写得多全而是把拦截点放在值提交之前。ValidatingEditor 就是这个点。