从零搭建半导体设备上位机(十二):参数设置页,表单校验、范围校验与配方联动

参数设置页:表单校验、范围校验与配方联动

这是「从零搭建半导体设备上位机」系列第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。

也就是说:范围校验这套代码写了、绑了、配了,但从来没生效过。

注释给的理由是"无尘室内调机参数设置校验,暂时不需要"。翻译一下:调机阶段工程师要频繁输入各种极限值,范围校验会拦住他,所以先关掉。

这个决定在当时是合理的。但代价是:

  1. 所有 MinNum / MaxNum 的绑定都是死代码。20 个设置页里配的范围值,一个都没起作用。
  2. "暂时"变成了永久。代码里没有任何地方标记这个开关的状态,后来的人看 XAML 会以为校验是生效的。
  3. 真正危险的参数也没有保护。比如某个温度上限,输错一个数量级直接下发到 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;

校验规则要考虑"输入中间态",不能只考虑"最终态"。用户打字的过程里,大部分时刻值是"不合法"的。


本篇小结

  1. ValidationParams : DependencyObject 让校验参数能参与绑定;BindingProxy : Freezable 让规则能拿到 DataContext。
  2. 范围校验这套代码从来没生效过 ------一行 isValidationRequired = false 把 20 个页面的范围校验全关了。
  3. "暂时关掉"必须落在可见的地方(配置项),不能落在代码里。
  4. 跨字段校验 ValidationRule 做不到,只能在保存时做,而当前是缺的。

下一篇讲日志:四路输出、按级别分文件、运行时改落点,以及一个自定义的 LockingModel。


下期预告

第13篇:日志页与四路日志输出:现场问题怎么查

相关推荐
samble8 天前
从零搭建半导体设备上位机(九):拖拽与交互,Adorner、DragDrop 与晶圆拖放信息
wpf·拖拽·adorner
芝梵家电数据笔记9 天前
用字段表核对暖菜板长期使用条件:结构、暖区、质保边界
python·家电·数据校验·dataclass·选购
郝学胜-神的一滴10 天前
AI 编程智能体 27:吃透MCP通信机制
人工智能·python·langchain·wpf·numpy·scikit-learn
波力海苔夹心脆67510 天前
C# WPF 资源字典详解:ResourceDictionary、MergedDictionaries 与自定义控件案例
开发语言·c#·wpf·入门教程·resource·资源字典
陈仓主教11 天前
# WPF CheckBox 控件详解与使用—WPF 中的控件(6)--复选框控件(CheckBox)
wpf
光泽雨13 天前
WPF 音视频四大核心方案对比
wpf·音视频
浪扼飞舟13 天前
WPF(数据绑定)
wpf
samble14 天前
从零搭建半导体设备上位机(四):单实例、启动流程与配置文件,App 里那 526 行到底在干什么
wpf·配置文件·单实例
浪扼飞舟15 天前
WPF(控件的继承树、内容控件、布局控件)
wpf