模型状态
模型状态表示两个子系统的错误：模型绑定和模型验证。 源自模型绑定的错误通常是数据转换错误。 例如，在一个整数字段中输入一个“x”。 模型验证在模型绑定后发生，并报告数据不符合业务规则的错误。 例如，在需要 1 到 5 之间评分的字段中输入 0。
模型绑定和模型验证都在执行控制器操作或 Razor Pages 处理程序方法之前进行。 Web 应用负责检查 ModelState.IsValid 并做出相应响应。 Web 应用通常会重新显示包含错误消息的页面，如以下 Razor Pages 示例所示：
public async Task<IActionResult> OnPostAsync()
{
if (!ModelState.IsValid)
{
return Page();
}
_context.Movies.Add(Movie);
await _context.SaveChangesAsync();
return RedirectToPage("./Index");
}
对于 ASP.NET Core具有控制器和视图的 MVC，以下示例演示如何检查ModelState.IsValid控制器操作内部：
public async Task<IActionResult> Create(Movie movie)
{
if (!ModelState.IsValid)
{
return View(movie);
}
_context.Movies.Add(movie);
await _context.SaveChangesAsync();
return RedirectToAction(nameof(Index));
}
Web API 控制器不必检查 ModelState.IsValid 它们是否具有 [ApiController] 属性。 在此情况下，如果模型状态无效，将返回包含错误详细信息的自动 HTTP 400 响应。 有关详细信息，请参阅自动 HTTP 400 响应。
重新运行验证
验证自动进行，但是可能需要手动进行重复验证。 例如，你可能为属性计算一个值，并且希望将属性设置为所计算的值后，再重新运行验证。 若要重新运行验证，请调用 ModelStateDictionary.ClearValidationState 来清除特定于模型的验证，然后再调用 TryValidateModel 对模型进行验证：
public async Task<IActionResult> OnPostTryValidateAsync()
{
var modifiedReleaseDate = DateTime.Now.Date;
Movie.ReleaseDate = modifiedReleaseDate;
ModelState.ClearValidationState(nameof(Movie));
if (!TryValidateModel(Movie, nameof(Movie)))
{
return Page();
}
_context.Movies.Add(Movie);
await _context.SaveChangesAsync();
return RedirectToPage("./Index");
}
验证特性
通过验证特性可以为模型属性指定验证规则。 示例应用中的以下示例显示了一个使用验证属性进行批注的模型类。 属性 [ClassicMovie] 是自定义验证属性，其他属性是内置属性。 [ClassicMovieWithClientValidator] 未显示，它表示实现自定义特性的另一种方法。
public class Movie
{
public int Id { get; set; }
[Required]
[StringLength(100)]
public string Title { get; set; } = null!;
[ClassicMovie(1960)]
[DataType(DataType.Date)]
[Display(Name = "Release Date")]
public DateTime ReleaseDate { get; set; }
[Required]
[StringLength(1000)]
public string Description { get; set; } = null!;
[Range(0, 999.99)]
public decimal Price { get; set; }
public Genre Genre { get; set; }
public bool Preorder { get; set; }
}
