通过 ValidationSummary 控件在 ASP.NET Core 中提升模型验证体验 (通过validator做表单检验)

文章编号：17791 / 分类：本站公告 / 更新时间：2024-07-07 17:45:52 / 浏览：次

模型验证是 ASP.NET Core 中一个重要特性，它可以确保用户输入的数据符合特定的规则和约束。当模型验证失败时，ASP.NET Core 会自动生成验证错误消息。但是，默认情况下，这些错误消息是以一种简单、不直观的方式显示的。

ValidationSummary 控件提供了一种更友好的方式来显示模型验证错误。它是一个 HTML 辅助器，可以将所有验证错误消息组合成一个摘要，并将其显示在视图中。这使得用户更容易看到和理解验证失败的原因。

使用 ValidationSummary 控件

要使用 ValidationSummary 控件，需要在视图中添加以下代码：


 @Html.ValidationSummary(true)

这将生成一个摘要，其中包含模型验证失败的所有错误消息。摘要将以一个无序列表（

）。
还可以指定以下选项来自定义摘要的外观和行为：
- excludePropertyErrors: 指定是否排除模型验证错误的属性名称。默认为 false。
- messageType: 指定摘要中错误消息的类型。可以是 "Error"（红色）、"Warning"（黄色）或 "Success"（绿色）。默认为 "Error"。
- tag: 指定摘要的 HTML 标签。默认为 "ul"（无序列表）。
示例

以下示例展示了如何使用 ValidationSummary 控件来显示模型验证错误：
public class Person {public string Name { get; set; }public int Age { get; set; } }public class HomeController : Controller {public IActionResult Index(){ return View();}[HttpPost]public IActionResult Index(Person person){if (!ModelState.IsValid){return View(person);}return RedirectToAction("Success");} }public class IndexView : View {public IndexView(Person model) : base(model) { }public override void Execute(){@Html.ValidationSummary(true) } }
在这个示例中，IndexView（一个 Razor 视图）使用 ValidationSummary 控件来显示模型验证错误。当用户提交表单时，如果模型验证失败，验证错误将显示在摘要中。

结论

ValidationSummary 控件是一个强大的工具，可以提升 ASP.NET Core 中的模型验证体验。它可以将所有验证错误消息组合成一个清晰、简洁的摘要，使用户更容易看到和理解验证失败的原因。通过使用 ValidationSummary 控件，可以创建用户友好的表单，即使验证失败，也能提供良好的用户体验。