MAUI表单验证核心是绑定+Data Annotations+INotifyDataErrorInfo接口,需手动实现验证逻辑与错误通知,配合XAML设置实时提示和提交校验。

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)存每个属性的错误信息> - 每次设置属性值后(在
SetProperty后),调用验证并更新对应字段的错误集合,再触发ErrorsChanged - XAML 中给
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 接口跑通,后面扩展正则、自定义规则、异步验证(如用户名是否已存在)都容易加进去。










