《Dotnet9》系列-FluentValidation在C# WPF中的应用

时间如流水，只能流去不流回！

点赞再看，养成习惯，这是您给我创作的动力！

本文 Dotnet9 https://dotnet9.com 已收录，站长乐于分享dotnet相关技术，比如Winform、WPF、ASP.NET Core等，亦有C++桌面相关的Qt Quick和Qt Widgets等，只分享自己熟悉的、自己会的。

一、简介

介绍FluentValidation的文章不少，零度编程的介绍我引用下：FluentValidation 是一个基于 .NET 开发的验证框架，开源免费，而且优雅，支持链式操作，易于理解，功能完善，还是可与 MVC5、WebApi2 和 ASP.NET CORE 深度集成，组件内提供十几种常用验证器，可扩展性好，支持自定义验证器，支持本地化多语言。

其实它也可以用于WPF属性验证，本文主要也是讲解该组件在WPF中的使用，FluentValidation官网是： https://fluentvalidation.net/ 。

二、本文需要实现的功能

提供WPF界面输入验证，采用MVVM方式，需要以下功能：

能验证ViewModel中定义的简单属性；
能验证ViewModel中定义的复杂属性，比如对象属性的子属性，如VM有个学生属性Student,需要验证他的姓名、年龄等；
能简单提供两种验证样式；
没有了，就是前面3点…

先看实现效果图：

三、调研中遇到的问题

简单属性：验证ViewModel的普通属性比较简单，可以参考FluentValidation官网：链接，或者国外holymoo大神的代码： UserValidator.cs 。

复杂属性：我遇到的问题是，怎么验证ViewModel中对象属性的子属性？见第二个功能描述，FluentValidation的官网有Complex Properties的例子，但是我试了没效果，贴上官方源码截图：

最后我Google到这篇文章，根据该链接代码，ViewModel和子属性都实现IDataErrorInfo接口，即可实现复杂属性验证，文章中没有具体实现，但灵感是从这来的，就不具体说该链接代码了，有兴趣的读者可以点击链接阅读，下面说说博主自己的研发步骤(主要就是贴代码啦，您可以直接拉到文章末尾，那里赋有源码下载链接)。

四、开发步骤

4.1、创建工程、引入库

创建.Net Core WPF模板解决方案（.Net Framework模板也行）：WpfFluentValidation，引入Nuget包FluentValidation(8.5.1)。

4.2、创建测试实体类学生：Student.cs

此类用作ViewModel中的复杂属性使用，学生类包含3个属性：名字、年龄、邮政编码。此实体需要继承IDataErrorInfo接口，这是触发FluentValidation验证的关键接口实现。

using System.ComponentModel;

using System.Linq;

using WpfFluentValidation.Validators;

namespace WpfFluentValidation.Models

{

    /// <summary>

    /// 学生实体

    /// 继承BaseClasss,即继承属性变化接口INotifyPropertyChanged

    /// 实现IDataErrorInfo接口，用于FluentValidation验证，必须实现此接口

    /// </summary>

    public class Student : BaseClass, IDataErrorInfo

    {

        private string name;

        public string Name

        {

            get { return name; }

            set

            {

                if (value != name)

                {

                    name = value;

                    OnPropertyChanged(nameof(Name));

                }

            }

        }

        private int age;

        public int Age

        {

            get { return age; }

            set

            {

                if (value != age)

                {

                    age = value;

                    OnPropertyChanged(nameof(Age));

                }

            }

        }

        private string zip;

        public string Zip

        {

            get { return zip; }

            set

            {

                if (value != zip)

                {

                    zip = value;

                    OnPropertyChanged(nameof(Zip));

                }

            }

        }

        public string Error { get; set; }

        public string this[string columnName]

        {

            get

            {

                if (validator == null)

                {

                    validator = new StudentValidator();

                }

                var firstOrDefault = validator.Validate(this)

                    .Errors.FirstOrDefault(lol => lol.PropertyName == columnName);

                return firstOrDefault?.ErrorMessage;

            }

        }

        private StudentValidator validator { get; set; }

    }

}

4.3、创建学生验证器：StudentValidator.cs

验证属性的写法有两种：

可以在实体属性上方添加特性（本文不作特别说明，百度文章介绍很多）；
通过代码的形式添加，如下方，创建一个验证器类，继承自AbstractValidator，在此验证器构造函数中写规则验证属性，方便管理。

本文使用第二种，见下方学生验证器代码：

using FluentValidation;

using System.Text.RegularExpressions;

using WpfFluentValidation.Models;

namespace WpfFluentValidation.Validators

{

    public class StudentValidator : AbstractValidator<Student>

    {

        public StudentValidator()

        {

            RuleFor(vm => vm.Name)

                    .NotEmpty()

                    .WithMessage("请输入学生姓名！")

                .Length(, )

                .WithMessage("学生姓名长度限制在5到30个字符之间！");

            RuleFor(vm => vm.Age)

                .GreaterThanOrEqualTo()

                .WithMessage("学生年龄为整数！")

                .ExclusiveBetween(, )

                .WithMessage($"请正确输入学生年龄(10-150)");

            RuleFor(vm => vm.Zip)

                .NotEmpty()

                .WithMessage("邮政编码不能为空！")

                .Must(BeAValidZip)

                .WithMessage("邮政编码由六位数字组成。");

        }

        private static bool BeAValidZip(string zip)

        {

            if (!string.IsNullOrEmpty(zip))

            {

                var regex = new Regex(@"\d{6}");

                return regex.IsMatch(zip);

            }

            return false;

        }

    }

}

4.4、创建ViewModel类：StudentViewModel.cs

StudentViewModel与Student实体类结构类似，都需要实现IDataErrorInfo接口，该类由一个简单的string属性(Title)和一个复杂的Student对象属性(CurrentStudent)组成，代码如下：

using System;

using System.ComponentModel;

using System.Linq;

using WpfFluentValidation.Models;

using WpfFluentValidation.Validators;

namespace WpfFluentValidation.ViewModels

{

    /// <summary>

    /// 视图ViewModel

    /// 继承BaseClasss,即继承属性变化接口INotifyPropertyChanged

    /// 实现IDataErrorInfo接口，用于FluentValidation验证，必须实现此接口

    /// </summary>

    public class StudentViewModel : BaseClass, IDataErrorInfo

    {

        private string title;

        public string Title

        {

            get { return title; }

            set

            {

                if (value != title)

                {

                    title = value;

                    OnPropertyChanged(nameof(Title));

                }

            }

        }

        private Student currentStudent;

        public Student CurrentStudent

        {

            get { return currentStudent; }

            set

            {

                if (value != currentStudent)

                {

                    currentStudent = value;

                    OnPropertyChanged(nameof(CurrentStudent));

                }

            }

        }

        public StudentViewModel()

        {

            CurrentStudent = new Student()

            {

                Name = "李刚的儿",

                Age =

            };

        }

        public string this[string columnName]

        {

            get

            {

                if (validator == null)

                {

                    validator = new ViewModelValidator();

                }

                var firstOrDefault = validator.Validate(this)

                    .Errors.FirstOrDefault(lol => lol.PropertyName == columnName);

                return firstOrDefault?.ErrorMessage;

            }

        }

        public string Error

        {

            get

            {

                var results = validator.Validate(this);

                if (results != null && results.Errors.Any())

                {

                    var errors = string.Join(Environment.NewLine, results.Errors.Select(x => x.ErrorMessage).ToArray());

                    return errors;

                }

                return string.Empty;

            }

        }

        private ViewModelValidator validator;

    }

}

仔细看上方代码，对比Student.cs，重写自IDataErrorInfo接口定义的Error属性与定义有所不同。Student.cs对Error基本未做修改，而StudentViewModel.cs有变化，get器中验证属性（简单属性Title和复杂属性CurrentStudent），返回错误提示字符串，诶，CurrentStudent的验证器怎么生效的？有兴趣的读者可以研究FluentValidation库源码一探究竟，博主表示研究源码其乐无穷，一时研究一时爽，一直研究一直爽。

4.5 StudentViewModel的验证器ViewModelValidator.cs

ViewModel的验证器，相比Student的验证器StudentValidator，就简单的多了，因为只需要编写验证一个简单属性Title的代码。而复杂属性CurrentStudent的验证器StudentValidator，将被WPF属性系统自动调用，即在StudentViewModel的索引器this[string columnName]和Error属性中调用，界面触发规则时自动调用。

using FluentValidation;

using WpfFluentValidation.ViewModels;

namespace WpfFluentValidation.Validators

{

    public class ViewModelValidator:AbstractValidator<StudentViewModel>

    {

        public ViewModelValidator()

        {

            RuleFor(vm => vm.Title)

                .NotEmpty()

                .WithMessage("标题长度不能为空！")

                .Length(, )

                .WithMessage("标题长度限制在5到30个字符之间！");

        }

    }

}

4.6 辅助类BaseClass.cs

简单封装INotifyPropertyChanged接口

using System.ComponentModel;

namespace WpfFluentValidation

{

    public class BaseClass : INotifyPropertyChanged

    {

        public event PropertyChangedEventHandler PropertyChanged;

        protected virtual void OnPropertyChanged(string propertyName)

        {

            PropertyChangedEventHandler handler = PropertyChanged;

            if (handler != null)

            {

                handler(this, new PropertyChangedEventArgs(propertyName));

            }

        }

    }

}

4.7 、视图StudentView.xaml

用户直接接触的视图文件来了，比较简单，提供简单属性标题(Title)、复杂属性学生姓名(CurrentStudent.Name)、学生年龄( CurrentStudent .Age)、学生邮政编码( CurrentStudent .Zip)验证，xaml代码如下：

<UserControl x:Class="WpfFluentValidation.Views.StudentView"

             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

             xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"

             xmlns:d="http://schemas.microsoft.com/expression/blend/2008"

             xmlns:local="clr-namespace:WpfFluentValidation.Views"

             xmlns:vm="clr-namespace:WpfFluentValidation.ViewModels"

             mc:Ignorable="d"

             d:DesignHeight="" d:DesignWidth="">

    <UserControl.DataContext>

        <vm:StudentViewModel/>

    </UserControl.DataContext>

    <Grid>

        <Grid.RowDefinitions>

            <RowDefinition Height="Auto"/>

            <RowDefinition Height="Auto"/>

            <RowDefinition Height="*"/>

        </Grid.RowDefinitions>

        <GroupBox Header="ViewModel直接属性验证">

            <StackPanel Orientation="Horizontal">

                <Label Content="标题："/>

                <TextBox Text="{Binding Title, UpdateSourceTrigger=PropertyChanged,ValidatesOnDataErrors=True}"

                         Style="{StaticResource ErrorStyle1}"/>

            </StackPanel>

        </GroupBox>

        <GroupBox Header="ViewModel对象属性CurrentStudent的属性验证" Grid.Row="">

            <StackPanel>

                <StackPanel Orientation="Horizontal">

                    <Label Content="姓名："/>

                    <TextBox Text="{Binding CurrentStudent.Name, UpdateSourceTrigger=PropertyChanged,ValidatesOnDataErrors=True}"

                         Style="{StaticResource ErrorStyle2}"/>

                </StackPanel>

                <StackPanel Orientation="Horizontal">

                    <Label Content="年龄："/>

                    <TextBox Text="{Binding CurrentStudent.Age, UpdateSourceTrigger=PropertyChanged,ValidatesOnDataErrors=True}"

                         Style="{StaticResource ErrorStyle2}"/>

                </StackPanel>

                <StackPanel Orientation="Horizontal">

                    <Label Content="邮编：" />

                    <TextBox Text="{Binding CurrentStudent.Zip, UpdateSourceTrigger=PropertyChanged,ValidatesOnDataErrors=True}"

                         Style="{StaticResource ErrorStyle2}"/>

                </StackPanel>

            </StackPanel>

        </GroupBox>

    </Grid>

</UserControl>

4.8 、错误提示样式

本文提供了两种样式，具体效果见前面的截图，代码如下：

<Application x:Class="WpfFluentValidation.App"

             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

             xmlns:local="clr-namespace:WpfFluentValidation"

             StartupUri="MainWindow.xaml">

    <Application.Resources>

        <Style TargetType="StackPanel">

            <Setter Property="Margin" Value="0 5"/>

        </Style>

        <!--第一种错误样式，红色边框-->

        <Style TargetType="{x:Type TextBox}" x:Key="ErrorStyle1">

            <Setter Property="Width" Value=""/>

            <Setter Property="Validation.ErrorTemplate">

                <Setter.Value>

                    <ControlTemplate>

                        <DockPanel>

                            <Grid DockPanel.Dock="Right" Width="" Height=""

                            VerticalAlignment="Center" Margin="3 0 0 0">

                                <Ellipse Width="" Height="" Fill="Red"/>

                                <Ellipse Width="" Height=""

                                VerticalAlignment="Top" HorizontalAlignment="Center"

                                Margin="0 2 0 0" Fill="White"/>

                                <Ellipse Width="" Height="" VerticalAlignment="Bottom"

                                HorizontalAlignment="Center" Margin="0 0 0 2"

                                Fill="White"/>

                            </Grid>

                            <Border BorderBrush="Red" BorderThickness="" CornerRadius="">

                                <AdornedElementPlaceholder/>

                            </Border>

                        </DockPanel>

                    </ControlTemplate>

                </Setter.Value>

            </Setter>

            <Style.Triggers>

                <Trigger Property="Validation.HasError" Value="true">

                    <Setter Property="ToolTip" Value="{Binding RelativeSource=

                            {x:Static RelativeSource.Self},

                            Path=(Validation.Errors)[].ErrorContent}"/>

                </Trigger>

            </Style.Triggers>

        </Style>

        <!--第二种错误样式，右键文字提示-->

        <Style TargetType="{x:Type TextBox}" x:Key="ErrorStyle2">

            <Setter Property="Width" Value=""/>

            <Setter Property="Validation.ErrorTemplate">

                <Setter.Value>

                    <ControlTemplate>

                        <StackPanel Orientation="Horizontal">

                            <AdornedElementPlaceholder x:Name="textBox"/>

                            <TextBlock Margin="" Text="{Binding [0].ErrorContent}" Foreground="Red"/>

                        </StackPanel>

                    </ControlTemplate>

                </Setter.Value>

            </Setter>

            <Style.Triggers>

                <Trigger Property="Validation.HasError" Value="true">

                    <Setter Property="ToolTip" Value="{Binding RelativeSource=

                    {x:Static RelativeSource.Self},

                    Path=(Validation.Errors)[].ErrorContent}"/>

                </Trigger>

            </Style.Triggers>

        </Style>

    </Application.Resources>

</Application>

五、介绍完毕

码农就是这样，文章基本靠贴代码，哈哈。

6、源码同步

本文代码已同步gitee: https://gitee.com/lsq6/FluentValidationForWpf

github： https://github.com/dotnet9/FluentValidationForWPF

CSDN： https://download.csdn.net/download/HenryMoore/11984265