绑定数据中加入校验

一、什么是绑定校验？

一句话定义：
在数据从界面写回数据源的过程中，自动检查输入是否合法，不合法就提示错误。

常见场景：

• 输入框不能为空
• 年龄必须是 1-100 之间的数字
• 密码长度不能小于 6 位
• 邮箱格式必须正确

二、WPF 提供的 2 种校验方式

1. 异常验证（最简单，推荐新手）

后台属性 set 方法里抛异常，界面自动捕获并提示。

2. 验证规则（ValidationRule）

纯 XAML 或独立类编写校验规则，不污染业务代码（更规范）。

三、必备前提

要让校验生效，绑定必须开启校验：

ValidatesOnDataErrors="True" 
ValidatesOnExceptions="True"
NotifyOnValidationError="True"

四、方式 1：异常验证（最简单，5 分钟学会）

步骤 1：后台属性里做判断，抛异常

public class Student : INotifyPropertyChanged
{
    private int _age;

    public int Age
    {
        get => _age;
        set
        {
            // 校验逻辑
            if (value < 1 || value > 100)
            {
                // 抛异常，WPF 自动捕获
                throw new ArgumentOutOfRangeException("年龄必须在 1-100 之间！");
            }

            _age = value;
            OnPropertyChanged();
        }
    }

    // ... 接口实现代码不变 ...
}

步骤 2：界面绑定开启校验

<TextBox 
    Text="{Binding Age, 
            Mode=TwoWay, 
            ValidatesOnExceptions=True,  <!-- 开启异常验证 -->
            UpdateSourceTrigger=PropertyChanged}"  <!-- 输入时实时校验 -->
    FontSize="20"
    Width="200"/>

效果

• 输入 0 → 自动出现红色边框
• 输入 101 → 自动报错
• 输入 18 → 正常

五、方式 2：独立验证规则（ValidationRule，企业级推荐）

这种方式不修改后台代码，校验逻辑独立，更干净。

步骤 1：创建校验规则类

继承 ValidationRule

public class AgeValidationRule : ValidationRule
{
    // 核心方法：校验逻辑
    public override ValidationResult Validate(object value, CultureInfo cultureInfo)
    {
        // 判断是否为空
        if (string.IsNullOrEmpty(value?.ToString()))
        {
            return new ValidationResult(false, "年龄不能为空！");
        }

        // 判断是否是数字
        if (!int.TryParse(value.ToString(), out int age))
        {
            return new ValidationResult(false, "必须输入数字！");
        }

        // 判断范围
        if (age < 1 || age > 100)
        {
            return new ValidationResult(false, "年龄必须在 1-100 之间！");
        }

        // 验证通过
        return ValidationResult.ValidResult;
    }
}

步骤 2：在 XAML 绑定中加入规则

<TextBox FontSize="20" Width="200">
    <TextBox.Text>
        <Binding Path="Age" Mode="TwoWay" UpdateSourceTrigger=PropertyChanged>
            <Binding.ValidationRules>
                <!-- 加入我们的校验规则 -->
                <local:AgeValidationRule/>
            </Binding.ValidationRules>
        </Binding>
    </TextBox.Text>
</TextBox>

效果

• 空 → 报错
• 字母 → 报错
• 101 → 报错
• 18 → 正常

六、方式 3：IDataErrorInfo（最常用、最强大）

MVVM 标准验证方式，一个类统一管理所有验证。

步骤 1：类继承 IDataErrorInfo

public class Student : INotifyPropertyChanged, IDataErrorInfo
{
    public string Name { get; set; }
    public int Age { get; set; }

    // 索引器：根据属性名做校验
    public string this[string columnName]
    {
        get
        {
            string error = string.Empty;

            switch (columnName)
            {
                case nameof(Age):
                    if (Age < 1 || Age > 100)
                        error = "年龄必须在1-100之间";
                    break;

                case nameof(Name):
                    if (string.IsNullOrWhiteSpace(Name))
                        error = "姓名不能为空";
                    break;
            }
            return error;
        }
    }

    public string Error => string.Empty;
}

步骤 2：绑定开启 IDataErrorInfo 校验

<TextBox 
    Text="{Binding Age, 
            ValidatesOnDataErrors=True,  <!-- 开启 -->
            NotifyOnValidationError=True,
            UpdateSourceTrigger=PropertyChanged}" />

效果

自动校验，自动红色提示。

七、显示错误提示信息（不只是红框，还要文字）

默认只有红框，我们可以显示错误文字：

<StackPanel>
    <TextBox x:Name="txtAge" Width="200" FontSize="20">
        <!-- 绑定+校验代码 -->
    </TextBox>

    <!-- 显示错误信息 -->
    <TextBlock 
        Foreground="Red" 
        Text="{Binding ElementName=txtAge, Path=(Validation.Errors)[0].ErrorContent}"
        Visibility="{Binding ElementName=txtAge, Path=(Validation.HasError), Converter={x:Static local:BoolToVisibilityConverter.Instance}}"/>
</StackPanel>

八、3 种方式对比（新手必看）

方式	难度	优点	适用场景
异常验证	🌟	最简单	小项目、快速开发
ValidationRule	🌟🌟	独立、干净	复用校验规则
IDataErrorInfo	🌟🌟🌟	MVVM 标准、强大	企业级、正式项目

 

 

九、绑定校验必加的 3 个属性

ValidatesOnExceptions="True"       <!-- 捕获异常 -->
ValidatesOnDataErrors="True"       <!-- 捕获 IDataErrorInfo -->
NotifyOnValidationError="True"     <!-- 触发错误通知 -->
UpdateSourceTrigger="PropertyChanged"  <!-- 实时校验 -->

十、完整模板（复制即用）

1. 校验规则类

public class MyRule : ValidationRule
{
    public override ValidationResult Validate(object value, CultureInfo cultureInfo)
    {
        // 你的校验逻辑
        return ValidationResult.ValidResult;
    }
}

2. XAML 绑定

<TextBox>
    <TextBox.Text>
        <Binding Path="xxx" UpdateSourceTrigger=PropertyChanged>
            <Binding.ValidationRules>
                <local:MyRule/>
            </Binding.ValidationRules>
        </Binding>
    </TextBox.Text>
</TextBox>

十一、核心总结（1 分钟记住）

1. WPF 自带校验，不用自己写弹窗、判断
2. 3 种方式：异常、ValidationRule、IDataErrorInfo
3. 绑定必须开启：ValidatesOnExceptions、ValidatesOnDataErrors
4. 实时校验：UpdateSourceTrigger=PropertyChanged
5. 错误显示：红色边框 + 错误文字提示