参数设置页:表单校验、范围校验与配方联动
这是「从零搭建半导体设备上位机」系列第12篇。参数设置页看起来是最枯燥的一块------一堆输入框加一个保存按钮。但它藏着这套代码里我最想删掉的一行。
四个文件,162 行,管着 20 个设置页
参数设置的校验代码只有四个文件:
| 文件 | 行数 | 作用 |
|---|---|---|
NumericValidationRule.cs |
50 | 数字 + 范围校验 |
GreaterThan0ValidationRule.cs |
34 | 大于某个值 |
ValidationParams.cs |
21 | 把参数包装成依赖属性 |
BindingProxy.cs |
27 | 让校验规则能拿到 DataContext |
一共 162 行,服务 20 个设置页(腔体 A/B/C、Buffer、Loadlock、轴、报警、厂商...)。
少,是因为校验规则是通用的;坑多,也是因为通用。

一、为什么校验规则要包一层 ValidationParams
WPF 的 ValidationRule 用法是这样:
xml
<TextBox>
<TextBox.Text>
<Binding Path="MaxSpeed">
<Binding.ValidationRules>
<local:NumericValidationRule MinNum="0" MaxNum="1000" />
</Binding.ValidationRules>
</Binding>
</TextBox.Text>
</TextBox>
问题:MinNum / MaxNum 只能是字面量。如果范围是动态的(比如"最大值等于另一个输入框的值"),就没法写。
解法是把参数包成依赖属性:
csharp
public class ValidationParams : DependencyObject
{
public object Data
{
get => GetValue(DataProperty);
set => SetValue(DataProperty, value);
}
public static readonly DependencyProperty DataProperty =
DependencyProperty.Register("Data", typeof(object), typeof(ValidationParams), new PropertyMetadata(null));
}
然后:
csharp
public class NumericValidationRule : ValidationRule
{
public ValidationParams MinNum { get; set; }
public ValidationParams MaxNum { get; set; }
public ValidationParams IsValidationRequired { get; set; }
}
XAML 里就能绑了:
xml
<local:NumericValidationRule>
<local:NumericValidationRule.MinNum>
<local:ValidationParams Data="{Binding MinAllowed}" />
</local:NumericValidationRule.MinNum>
</local:NumericValidationRule>
为什么要 DependencyObject :只有依赖属性才能参与 WPF 的绑定系统。普通 CLR 属性在 ValidationRule 里是拿不到绑定的。
二、BindingProxy:一个老掉牙但必须知道的技巧
ValidationRule 不在可视树里,所以拿不到 DataContext。
想在规则里访问 ViewModel 的属性(比如"当前配方允许的最大值"),直接 {Binding ...} 是无效的。
标准解法是 BindingProxy------一个 Freezable 子类:
csharp
public class BindingProxy : Freezable
{
protected override Freezable CreateInstanceCore() => new BindingProxy();
public object Data
{
get => GetValue(DataProperty);
set => SetValue(DataProperty, value);
}
public static readonly DependencyProperty DataProperty =
DependencyProperty.Register("Data", typeof(object), typeof(BindingProxy), new PropertyMetadata(null));
}
在资源里声明一次:
xml
<local:BindingProxy x:Key="Proxy" Data="{Binding}" />
然后在规则里引用:
xml
<local:NumericValidationRule MinNum="{Binding Source={StaticResource Proxy}, Path=Data.MinAllowed}" />
为什么是 Freezable 而不是普通的 DependencyObject :Freezable 可以跨可视树边界继承 DataContext,普通 DependencyObject 不行。这个区别是 WPF 里最反直觉的地方之一------同样的写法,换个基类就失效。
三、那行被硬编码关掉的校验
NumericValidationRule.Validate 里是这样:
csharp
var isValidationRequired = (bool)IsValidationRequired.Data;
isValidationRequired = false; // 无尘室内调机参数设置校验,暂时不需要,后续需要再打开
if (isValidationRequired)
{
var minNum = (double)MinNum.Data;
var maxNum = (double)MaxNum.Data;
if (result < minNum || result > maxNum)
return new ValidationResult(false, $"输入的数字必须要在 {minNum}和{maxNum}之间");
}
return ValidationResult.ValidResult;
第一行从绑定里取值,第二行立刻覆盖成 false。
也就是说:范围校验这套代码写了、绑了、配了,但从来没生效过。
注释给的理由是"无尘室内调机参数设置校验,暂时不需要"。翻译一下:调机阶段工程师要频繁输入各种极限值,范围校验会拦住他,所以先关掉。
这个决定在当时是合理的。但代价是:
- 所有
MinNum/MaxNum的绑定都是死代码。20 个设置页里配的范围值,一个都没起作用。 - "暂时"变成了永久。代码里没有任何地方标记这个开关的状态,后来的人看 XAML 会以为校验是生效的。
- 真正危险的参数也没有保护。比如某个温度上限,输错一个数量级直接下发到 PLC。
正确的做法
不该用硬编码覆盖,应该做成配置:
csharp
// 从配置读,调机模式关闭,生产模式开启
isValidationRequired = AppIniConfig.EnableParamRangeCheck;
然后在 Config.ini 里放一个开关,装机时设成 true,调机时设成 false。
关键差别 :配置开关是可见的 ------装机检查清单里能看到这一项;硬编码是不可见的------只有读过这 50 行代码的人才知道校验被关了。
这一条可以推广成规则:任何"暂时关掉"的逻辑,都必须落在一个能被检查的地方(配置项、界面开关、启动参数),不能落在代码里。
四、配方联动:参数不是孤立的
参数设置页最容易忽略的是参数之间的关系。
举例:某个腔体的"最大功率"和"升温速率"是耦合的------功率上限改了,升温速率的合理范围也跟着变。
当前实现里,两个参数各校验各的,互不知道对方。后果是能配出一组"单独看都合法、组合起来不可能实现"的参数。
这类跨字段校验,WPF 的 ValidationRule 做不到(它是单字段的)。只能在保存时做:
csharp
var errors = ValidateCombination(recipe);
if (errors.Any())
{
HcGrowlExtensions.Warn(string.Join(";", errors));
return;
}
现在的代码里这一步是缺的。配方保存只做了单字段校验(而且还是关着的)。
踩坑记录
坑一:ValidationResult 的错误信息不显示
ValidationRule 返回 new ValidationResult(false, "输入的不是数字"),但界面上什么都没显示。
原因:TextBox 默认的错误模板是在控件周围画一圈红边 ,不显示文字。要显示文字得自己写 Validation.ErrorTemplate。
后来在 FormDictionary.xaml 里统一定义了错误模板:红边框 + 下方一行小字。
这是"校验生效了但用户不知道"的典型------技术上正确,体验上等于没做。
坑二:校验失败仍然能保存
Validation.HasError 为 true 时,绑定的值不会写回 ViewModel。但保存按钮没有检查这个状态。
结果:用户输了个非法值,界面标红,点保存------保存的是上一次的合法值,用户以为存进去了。
正确做法是在保存命令的 CanExecute 里检查所有绑定元素的 Validation.HasError:
csharp
[RelayCommand(CanExecute = nameof(CanSave))]
private void Save() { ... }
private bool CanSave() => !HasValidationError();
[RelayCommand] 的 CanExecute 不会自动重算(第 3 篇讲过),所以还要在 Validation.Error 事件里手动 NotifyCanExecuteChanged()。
坑三:double.TryParse 对空字符串返回 true
csharp
if (value != null && !double.TryParse(value.ToString(), out result))
return new ValidationResult(false, "输入的不是数字");
空字符串 "" 传进 TryParse,返回 false(解析失败),所以会报"输入的不是数字"。
但用户只是清空了输入框准备重新输入,这时候报错很烦。
修法是先判空:
csharp
if (string.IsNullOrWhiteSpace(value?.ToString())) return ValidationResult.ValidResult;
校验规则要考虑"输入中间态",不能只考虑"最终态"。用户打字的过程里,大部分时刻值是"不合法"的。
本篇小结
ValidationParams : DependencyObject让校验参数能参与绑定;BindingProxy : Freezable让规则能拿到DataContext。- 范围校验这套代码从来没生效过 ------一行
isValidationRequired = false把 20 个页面的范围校验全关了。 - "暂时关掉"必须落在可见的地方(配置项),不能落在代码里。
- 跨字段校验
ValidationRule做不到,只能在保存时做,而当前是缺的。
下一篇讲日志:四路输出、按级别分文件、运行时改落点,以及一个自定义的 LockingModel。
下期预告
第13篇:日志页与四路日志输出:现场问题怎么查