MAUI 表单验证主要靠绑定 + 数据注解(Data Annotations)+
INotifyDataErrorInfo接口实现,核心是让 UI 能实时响应数据合法性变化,并给出用户友好的提示。不依赖第三方库也能完成基础到中等复杂度的验证。
用 Data Annotations 定义规则
在 ViewModel 或 Model 类的属性上加验证特性,比如
[Required]、
[EmailAddress]、
[StringLength(10, MinimumLength = 3)]等。MAUI 本身不自动读取这些特性,但配合后续接口就能触发验证逻辑。 确保类实现
INotifyPropertyChanged,用于通知界面属性值变化 验证特性只是“声明”,真正执行要靠手动调用
Validator.TryValidateObject或封装验证方法 建议把验证逻辑集中写在 ViewModel 的一个方法里,比如
ValidateForm()
实现 INotifyDataErrorInfo 接口(关键步骤)
这是 MAUI(及 Xamarin.Forms)推荐的验证通信方式,能让
Entry、
Editor等控件自动显示错误提示(需配合
ValidatesOnNotifyDataErrors=True)。 在 ViewModel 中实现
INotifyDataErrorInfo的三个成员:
HasErrors、
GetErrors(string propertyName)、
ErrorsChanged事件 用字典(如
Dictionary<string list>></string>)存每个属性的错误信息 每次设置属性值后(在
SetProperty后),调用验证并更新对应字段的错误集合,再触发
ErrorsChangedXAML 中给
Entry加上
ValidatesOnNotifyDataErrors="True"和
NotifyOnValidationError="True"
在 XAML 中显示错误提示
MAUI 不自带红色边框或 Tooltip,需要手动控制 UI 状态:
用VisualStateManager定义
Invalid状态,修改
Entry的
BackgroundColor或
BorderColor加一个
Label绑定到
{Binding GetErrors[Email][0]}(需用 MultiBinding或封装为只读属性更稳妥) 或者用
ToolTipProperties.Text显示简短提示(仅支持部分平台,如 Windows) 提交按钮用
IsEnabled="{Binding HasErrors, Converter={StaticResource InverseBoolConverter}}" 禁用
手动触发验证(如点击提交时)
除了实时验证,提交前应全量校验并滚动到首个错误项:
调用ValidateAllProperties()方法,遍历所有带验证特性的属性并收集错误 设置
HasErrors = true并触发
ErrorsChanged,让所有控件刷新状态 用
ScrollView.ScrollToAsync()滚动到第一个有错误的
Entry(需给它命名并用
FindByName) 避免只校验“已修改字段”,提交时必须校验全部必填项
基本上就这些。MAUI 验证没那么自动化,但结构清晰、可控性强。重点是把
INotifyDataErrorInfo接口跑通,后面扩展正则、自定义规则、异步验证(如用户名是否已存在)都容易加进去。
