第 8 部分：添加验证 | Microsoft Learn

link之家

链接快照平台

输入网页链接，自动生成快照
标签化管理网页链接

将验证规则添加到电影模型

System.ComponentModel.DataAnnotations 命名空间提供以下内容：

一组内置验证特性，可通过声明方式应用于类或属性。


    [DataType]

等格式特性，这些特性可帮助进行格式设置，但不提供任何验证。

更新 Movie 类以使用内置的 [Required] 、 [StringLength] 、 [RegularExpression] 和 [Range] 验证特性。

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace RazorPagesMovie.Models;
public class Movie
    public int Id { get; set; }
    [StringLength(60, MinimumLength = 3)]
    [Required]
    public string Title { get; set; } = string.Empty;
    [DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    [Range(1, 100)]
    [DataType(DataType.Currency)]
    [Column(TypeName = "decimal(18, 2)")]
    public decimal Price { get; set; }
    [RegularExpression(@"^[A-Z]+[a-zA-Z\s]*$")]
    [Required]
    [StringLength(30)]
    public string Genre { get; set; } = string.Empty;
    [RegularExpression(@"^[A-Z]+[a-zA-Z0-9""'\s-]*$")]
    [StringLength(5)]
    [Required]
    public string Rating { get; set; } = string.Empty;
验证特性指定要对应用这些特性的模型属性强制执行的行为：
[Required] 和 [MinimumLength] 特性指示属性必须具有一个值。 不阻止用户输入空格来满足此验证。
[RegularExpression] 特性用于限制可输入的字符。 在上述代码中，Genre：
只能使用字母。
第一个字母必须为大写。 允许使用空格，但不允许使用数字和特殊字符。
RegularExpression Rating：
要求第一个字符为大写字母。
允许在后续空格中使用特殊字符和数字。 “PG-13”对“分级”有效，但对于“Genre”无效。
[Range] 特性将值限制在指定的范围内。
[StringLength] 特性可以设置字符串属性的最大长度，以及可选的最小长度。
从本质上来说，需要值类型（如 decimal、int、float、DateTime），但不需要 [Required] 特性。
上述验证规则用于进行演示，它们并不是适用于生产系统的最佳规则。 例如，前面的规则会阻止用户仅使用两个字符输入一部电影，并且不允许 Genre 中有特殊字符。
让 ASP.NET Core 强制自动执行验证规则有助于：
提升应用的可靠性。
减少将无效数据保存到数据库的几率。
Razor 页面中的验证错误 UI
运行应用并导航到“页面/电影”。
选择“新建”链接。 使用无效值填写表单。 当 jQuery 客户端验证检测到错误时，会显示一条错误消息。
可能无法在小数字段中输入十进制逗号。 若要使 jQuery 验证支持使用逗号（“,”）表示小数点的的非英语区域设置，以及支持非美国英语日期格式，必须执行使应用全球化的步骤。 有关添加十进制逗号的说明，请参阅此 GitHub 注释 4076。
请注意表单如何自动呈现每个包含无效值的字段中的验证错误消息。 客户端（使用 JavaScript 和 jQuery）和服务器端（若用户禁用 JavaScript）都必定会遇到这些错误。
一项重要优势是，无需在“创建”或“编辑”页面中更改代码。 在模型应用数据注释后，即已启用验证 UI。 本教程中创建的 Razor 页面自动选取了验证规则（使用 Movie 模型类的属性上的验证特性）。 使用“编辑”页面测试验证后，即已应用相同验证。
存在客户端验证错误时，不会将表单数据发布到服务器。 请通过以下一种或多种方法验证是否未发布表单数据：
在 OnPostAsync 方法中放置一个断点。 通过选择“创建”或“保存”来提交表单 。 从未命中断点。
使用 Fiddler 工具。
使用浏览器开发人员工具监视网络流量。
服务器端验证
在浏览器中禁用 JavaScript 后，提交出错表单将发布到服务器。
（可选）测试服务器端验证：
在浏览器中禁用 JavaScript。 可以使用浏览器的开发人员工具禁用 JavaScript。 如果无法在此浏览器中禁用 JavaScript，请尝试其他浏览器。
在“创建”或“编辑”页面的 OnPostAsync 方法中设置断点。
提交包含无效数据的表单。
验证模型状态是否无效：
 if (!ModelState.IsValid)
    return Page();
或者可以禁用服务器上的客户端验证。
以下代码显示了之前在本教程中设定其基架的 Create.cshtml 的一部分。 “创建”和“编辑”页面使用它来实现以下操作：
显示初始表单。
在出现错误时重现显示此表单。
<form method="post">
    <div asp-validation-summary="ModelOnly" class="text-danger"></div>
    <div class="form-group">
        <label asp-for="Movie.Title" class="control-label"></label>
        <input asp-for="Movie.Title" class="form-control" />
        <span asp-validation-for="Movie.Title" class="text-danger"></span>
输入标记帮助程序使用 DataAnnotations 特性并在客户端生成 jQuery 验证所需的 HTML 特性。 验证标记帮助程序用于显示验证错误。 有关详细信息，请参阅验证。
“创建”和“编辑”页面中没有验证规则。 仅可在 Movie 类中指定验证规则和错误字符串。 这些验证规则将自动应用于编辑 Movie 模型的 Razor 页面。
需要更改验证逻辑时，也只能在该模型中更改。 将始终在整个应用中应用验证（在一处定义验证逻辑）。 单处验证有助于保持代码干净，且更易于维护和更新。
使用 DataType 特性
检查 Movie 类。 除了一组内置的验证特性，System.ComponentModel.DataAnnotations 命名空间还提供格式特性。 [DataType] 特性应用于 ReleaseDate 和 Price 属性。
[DataType(DataType.Date)]
public DateTime ReleaseDate { get; set; }
[Range(1, 100)]
[DataType(DataType.Currency)]
[Column(TypeName = "decimal(18, 2)")]
public decimal Price { get; set; }
[DataType] 特性提供以下内容：
提供提示，供视图引擎设置数据的格式。
提供属性，例如 URL 的 <a> 以及电子邮件的 <a href="mailto:EmailAddress.com">。
使用 [RegularExpression] 特性验证数据的格式。 [DataType] 属性用于指定比数据库内部类型更具体的数据类型。 [DataType] 特性不是验证特性。 示例应用中仅显示日期，不显示时间。
DataType 枚举提供多种数据类型，如 Date、Time、PhoneNumber、Currency、EmailAddress 等。
[DataType] 特性：
可以使应用自动提供类型特定的功能。 例如，可为 DataType.EmailAddress 创建 mailto: 链接。
可在支持 HTML5 的浏览器中提供 DataType.Date 日期选择器。
发出 HTML 5 data-（读作 data dash）特性供 HTML 5 浏览器使用。
不提供任何验证。
DataType.Date 不指定显示日期的格式。 默认情况下，数据字段根据基于服务器的 CultureInfo 的默认格式进行显示。
要使 Entity Framework Core 能将 Price 正确地映射到数据库中的货币，则必须使用 [Column(TypeName = "decimal(18, 2)")] 数据注释。 有关详细信息，请参阅数据类型。
[DisplayFormat] 特性用于显式指定日期格式：
[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
public DateTime ReleaseDate { get; set; }
ApplyFormatInEditMode 设置用于指定在显示值进行编辑时将应用格式。 某些字段可能不需要此行为。 例如，在货币值中，可能不希望编辑 UI 中存在货币符号。
可单独使用 [DisplayFormat] 特性，但通常建议使用 [DataType] 特性。 [DataType] 特性按照数据在屏幕上的呈现方式传达数据的语义。 [DataType] 特性可提供 [DisplayFormat] 所不具有的以下优点：
浏览器可启用 HTML5 功能（例如显示日历控件、区域设置适用的货币符号、电子邮件链接等）。
默认情况下，浏览器将根据区域设置采用正确的格式呈现数据。
借助 [DataType] 特性，ASP.NET Core 框架可选择适当的字段模板来呈现数据。 单独使用时，DisplayFormat 特性将使用字符串模板。
注意：jQuery 验证不适用于 [Range] 特性和 DateTime。 例如，以下代码将始终显示客户端验证错误，即便日期在指定的范围内：
[Range(typeof(DateTime), "1/1/1966", "1/1/2020")]
最佳做法是避免在模型中编译固定日期，因此不推荐使用 [Range] 特性和 DateTime。 使用配置指定日期范围和其他经常会更改的值，而不是在代码中指定它们。
以下代码显示组合在一行上的特性：
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace RazorPagesMovie.Models;
public class Movie
    public int Id { get; set; }
    [StringLength(60, MinimumLength = 3)]
    public string Title { get; set; } = string.Empty;
    [Display(Name = "Release Date"), DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    [RegularExpression(@"^[A-Z]+[a-zA-Z\s]*$"), Required, StringLength(30)]
    public string Genre { get; set; } = string.Empty;
    [Range(1, 100), DataType(DataType.Currency)]
    [Column(TypeName = "decimal(18, 2)")]
    public decimal Price { get; set; }
    [RegularExpression(@"^[A-Z]+[a-zA-Z0-9""'\s-]*$"), StringLength(5)]
    public string Rating { get; set; } = string.Empty;
Razor Pages 和 EF Core 入门显示了 Razor Pages 的高级 EF Core 操作。
应用于类的 DataAnnotations 会更改架构。 例如，应用于 Title 字段的 DataAnnotations 会：
[StringLength(60, MinimumLength = 3)]
[Required]
public string Title { get; set; } = string.Empty;
将字符数限制为 60。
不允许使用 null 值。
Movie 表当前具有以下架构：
CREATE TABLE [dbo].[Movie] (
    [ID]          INT             IDENTITY (1, 1) NOT NULL,
    [Title]       NVARCHAR (MAX)  NULL,
    [ReleaseDate] DATETIME2 (7)   NOT NULL,
    [Genre]       NVARCHAR (MAX)  NULL,
    [Price]       DECIMAL (18, 2) NOT NULL,
    [Rating]      NVARCHAR (MAX)  NULL,
    CONSTRAINT [PK_Movie] PRIMARY KEY CLUSTERED ([ID] ASC)
前面的架构更改不会导致 EF 引发异常。 不过，请创建迁移，使架构与模型保持一致。
Visual Studio
Visual Studio Code
使用以下命令为新的 DataAnnotations 添加迁移：
dotnet ef migrations add New_DataAnnotations
dotnet ef database update
dotnet ef database update 运行 New_DataAnnotations 类的 Up 方法。
检查 Up 方法：
public partial class New_DataAnnotations : Migration
    /// <inheritdoc />
    protected override void Up(MigrationBuilder migrationBuilder)
        migrationBuilder.AlterColumn<string>(
            name: "Title",
            table: "Movie",
            type: "nvarchar(60)",
            maxLength: 60,
            nullable: false,
            oldClrType: typeof(string),
            oldType: "nvarchar(max)");
        migrationBuilder.AlterColumn<string>(
            name: "Rating",
            table: "Movie",
            type: "nvarchar(5)",
            maxLength: 5,
            nullable: false,
            oldClrType: typeof(string),
            oldType: "nvarchar(max)");
        migrationBuilder.AlterColumn<string>(
            name: "Genre",
            table: "Movie",
            type: "nvarchar(30)",
            maxLength: 30,
            nullable: false,
            oldClrType: typeof(string),
            oldType: "nvarchar(max)");
更新的 Movie 表具有以下架构：
CREATE TABLE [dbo].[Movie] (
    [ID]          INT             IDENTITY (1, 1) NOT NULL,
    [Title]       NVARCHAR (60)   NOT NULL,
    [ReleaseDate] DATETIME2 (7)   NOT NULL,
    [Genre]       NVARCHAR (30)   NOT NULL,
    [Price]       DECIMAL (18, 2) NOT NULL,
    [Rating]      NVARCHAR (5)    NOT NULL,
    CONSTRAINT [PK_Movie] PRIMARY KEY CLUSTERED ([ID] ASC)
发布到 Azure
若要了解如何部署到 Azure，请参阅教程：使用 SQL 数据库在 Azure 中生成 ASP.NET Core 应用。
感谢读完这篇 Razor Pages 简介。 Razor Pages 和 EF Core 入门是本教程的优选后续教程。
ASP.NET Core 表单中的标记帮助程序
ASP.NET Core 全球化和本地化
ASP.NET Core 中的标记帮助程序
在 ASP.NET Core 中创作标记帮助程序
上一篇：添加新字段
本部分中向 Movie 模型添加了验证逻辑。 每当用户创建或编辑电影时，都会强制执行验证规则。
软件开发的一个关键原则被称为 DRY（即“不要自我重复”）  。 Razor 页面鼓励进行仅指定一次功能的开发，且功能在整个应用中反映。 DRY 可以帮助：
减少应用中的代码量。
使代码更加不易出错，且更易于测试和维护。
Razor 页面和实体框架提供的验证支持是 DRY 原则的极佳示例：
验证规则在模型类中的某处以声明方式指定。
规则在应用的所有位置强制执行。
将验证规则添加到电影模型
System.ComponentModel.DataAnnotations 命名空间提供以下内容：
一组内置验证特性，可通过声明方式应用于类或属性。
[DataType] 等格式特性，这些特性可帮助进行格式设置，但不提供任何验证。
更新 Movie 类以使用内置的 [Required]、[StringLength]、[RegularExpression] 和 [Range] 验证特性。
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace RazorPagesMovie.Models;
public class Movie
    public int Id { get; set; }
    [StringLength(60, MinimumLength = 3)]
    [Required]
    public string Title { get; set; } = string.Empty;
    [DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    [Range(1, 100)]
    [DataType(DataType.Currency)]
    [Column(TypeName = "decimal(18, 2)")]
    public decimal Price { get; set; }
    [RegularExpression(@"^[A-Z]+[a-zA-Z\s]*$")]
    [Required]
    [StringLength(30)]
    public string Genre { get; set; } = string.Empty;
    [RegularExpression(@"^[A-Z]+[a-zA-Z0-9""'\s-]*$")]
    [StringLength(5)]
    [Required]
    public string Rating { get; set; } = string.Empty;
验证特性指定要对应用这些特性的模型属性强制执行的行为：
[Required] 和 [MinimumLength] 特性指示属性必须具有一个值。 不阻止用户输入空格来满足此验证。
[RegularExpression] 特性用于限制可输入的字符。 在上述代码中，Genre：
只能使用字母。
第一个字母必须为大写。 允许使用空格，但不允许使用数字和特殊字符。
RegularExpression Rating：
要求第一个字符为大写字母。
允许在后续空格中使用特殊字符和数字。 “PG-13”对“分级”有效，但对于“Genre”无效。
[Range] 特性将值限制在指定的范围内。
[StringLength] 特性可以设置字符串属性的最大长度，以及可选的最小长度。
从本质上来说，需要值类型（如 decimal、int、float、DateTime），但不需要 [Required] 特性。
上述验证规则用于进行演示，它们并不是适用于生产系统的最佳规则。 例如，前面的规则会阻止用户仅使用两个字符输入一部电影，并且不允许 Genre 中有特殊字符。
让 ASP.NET Core 强制自动执行验证规则有助于：
提升应用的可靠性。
减少将无效数据保存到数据库的几率。
Razor 页面中的验证错误 UI
运行应用并导航到“页面/电影”。
选择“新建”链接。 使用无效值填写表单。 当 jQuery 客户端验证检测到错误时，会显示一条错误消息。
可能无法在小数字段中输入十进制逗号。 若要使 jQuery 验证支持使用逗号（“,”）表示小数点的的非英语区域设置，以及支持非美国英语日期格式，必须执行使应用全球化的步骤。 有关添加十进制逗号的说明，请参阅此 GitHub 注释 4076。
请注意表单如何自动呈现每个包含无效值的字段中的验证错误消息。 客户端（使用 JavaScript 和 jQuery）和服务器端（若用户禁用 JavaScript）都必定会遇到这些错误。
一项重要优势是，无需在“创建”或“编辑”页面中更改代码。 在模型应用数据注释后，即已启用验证 UI。 本教程中创建的 Razor 页面自动选取了验证规则（使用 Movie 模型类的属性上的验证特性）。 使用“编辑”页面测试验证后，即已应用相同验证。
存在客户端验证错误时，不会将表单数据发布到服务器。 请通过以下一种或多种方法验证是否未发布表单数据：
在 OnPostAsync 方法中放置一个断点。 通过选择“创建”或“保存”来提交表单 。 从未命中断点。
使用 Fiddler 工具。
使用浏览器开发人员工具监视网络流量。
服务器端验证
在浏览器中禁用 JavaScript 后，提交出错表单将发布到服务器。
（可选）测试服务器端验证：
在浏览器中禁用 JavaScript。 可以使用浏览器的开发人员工具禁用 JavaScript。 如果无法在此浏览器中禁用 JavaScript，请尝试其他浏览器。
在“创建”或“编辑”页面的 OnPostAsync 方法中设置断点。
提交包含无效数据的表单。
验证模型状态是否无效：
 if (!ModelState.IsValid)
    return Page();
或者可以禁用服务器上的客户端验证。
以下代码显示了之前在本教程中设定其基架的 Create.cshtml 的一部分。 “创建”和“编辑”页面使用它来实现以下操作：
显示初始表单。
在出现错误时重现显示此表单。
<form method="post">
    <div asp-validation-summary="ModelOnly" class="text-danger"></div>
    <div class="form-group">
        <label asp-for="Movie.Title" class="control-label"></label>
        <input asp-for="Movie.Title" class="form-control" />
        <span asp-validation-for="Movie.Title" class="text-danger"></span>
输入标记帮助程序使用 DataAnnotations 特性并在客户端生成 jQuery 验证所需的 HTML 特性。 验证标记帮助程序用于显示验证错误。 有关详细信息，请参阅验证。
“创建”和“编辑”页面中没有验证规则。 仅可在 Movie 类中指定验证规则和错误字符串。 这些验证规则将自动应用于编辑 Movie 模型的 Razor 页面。
需要更改验证逻辑时，也只能在该模型中更改。 将始终在整个应用中应用验证（在一处定义验证逻辑）。 单处验证有助于保持代码干净，且更易于维护和更新。
使用 DataType 特性
检查 Movie 类。 除了一组内置的验证特性，System.ComponentModel.DataAnnotations 命名空间还提供格式特性。 [DataType] 特性应用于 ReleaseDate 和 Price 属性。
[DataType(DataType.Date)]
public DateTime ReleaseDate { get; set; }
[Range(1, 100)]
[DataType(DataType.Currency)]
[Column(TypeName = "decimal(18, 2)")]
public decimal Price { get; set; }
[DataType] 特性提供以下内容：




    

提供提示，供视图引擎设置数据的格式。
提供属性，例如 URL 的 <a> 以及电子邮件的 <a href="mailto:EmailAddress.com">。
使用 [RegularExpression] 特性验证数据的格式。 [DataType] 属性用于指定比数据库内部类型更具体的数据类型。 [DataType] 特性不是验证特性。 示例应用中仅显示日期，不显示时间。
DataType 枚举提供多种数据类型，如 Date、Time、PhoneNumber、Currency、EmailAddress 等。
[DataType] 特性：
可以使应用自动提供类型特定的功能。 例如，可为 DataType.EmailAddress 创建 mailto: 链接。
可在支持 HTML5 的浏览器中提供 DataType.Date 日期选择器。
发出 HTML 5 data-（读作 data dash）特性供 HTML 5 浏览器使用。
不提供任何验证。
DataType.Date 不指定显示日期的格式。 默认情况下，数据字段根据基于服务器的 CultureInfo 的默认格式进行显示。
要使 Entity Framework Core 能将 Price 正确地映射到数据库中的货币，则必须使用 [Column(TypeName = "decimal(18, 2)")] 数据注释。 有关详细信息，请参阅数据类型。
[DisplayFormat] 特性用于显式指定日期格式：
[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
public DateTime ReleaseDate { get; set; }
ApplyFormatInEditMode 设置用于指定在显示值进行编辑时将应用格式。 某些字段可能不需要此行为。 例如，在货币值中，可能不希望编辑 UI 中存在货币符号。
可单独使用 [DisplayFormat] 特性，但通常建议使用 [DataType] 特性。 [DataType] 特性按照数据在屏幕上的呈现方式传达数据的语义。 [DataType] 特性可提供 [DisplayFormat] 所不具有的以下优点：
浏览器可启用 HTML5 功能（例如显示日历控件、区域设置适用的货币符号、电子邮件链接等）。
默认情况下，浏览器将根据区域设置采用正确的格式呈现数据。
借助 [DataType] 特性，ASP.NET Core 框架可选择适当的字段模板来呈现数据。 单独使用时，DisplayFormat 特性将使用字符串模板。
注意：jQuery 验证不适用于 [Range] 特性和 DateTime。 例如，以下代码将始终显示客户端验证错误，即便日期在指定的范围内：
[Range(typeof(DateTime), "1/1/1966", "1/1/2020")]
最佳做法是避免在模型中编译固定日期，因此不推荐使用 [Range] 特性和 DateTime。 使用配置指定日期范围和其他经常会更改的值，而不是在代码中指定它们。
以下代码显示组合在一行上的特性：
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace RazorPagesMovie.Models;
public class Movie
    public int Id { get; set; }
    [StringLength(60, MinimumLength = 3)]
    public string Title { get; set; } = string.Empty;
    [Display(Name = "Release Date"), DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    [RegularExpression(@"^[A-Z]+[a-zA-Z\s]*$"), Required, StringLength(30)]
    public string Genre { get; set; } = string.Empty;
    [Range(1, 100), DataType(DataType.Currency)]
    [Column(TypeName = "decimal(18, 2)")]
    public decimal Price { get; set; }
    [RegularExpression(@"^[A-Z]+[a-zA-Z0-9""'\s-]*$"), StringLength(5)]
    public string Rating { get; set; } = string.Empty;
Razor Pages 和 EF Core 入门显示了 Razor Pages 的高级 EF Core 操作。
应用于类的 DataAnnotations 会更改架构。 例如，应用于 Title 字段的 DataAnnotations 会：
[StringLength(60, MinimumLength = 3)]
[Required]
public string Title { get; set; } = string.Empty;
将字符数限制为 60。
不允许使用 null 值。
Movie 表当前具有以下架构：
CREATE TABLE [dbo].[Movie] (
    [ID]          INT             IDENTITY (1, 1) NOT NULL,
    [Title]       NVARCHAR (MAX)  NULL,
    [ReleaseDate] DATETIME2 (7)   NOT NULL,
    [Genre]       NVARCHAR (MAX)  NULL,
    [Price]       DECIMAL (18, 2) NOT NULL,
    [Rating]      NVARCHAR (MAX)  NULL,
    CONSTRAINT [PK_Movie] PRIMARY KEY CLUSTERED ([ID] ASC)
前面的架构更改不会导致 EF 引发异常。 不过，请创建迁移，使架构与模型保持一致。
Visual Studio
Visual Studio Code / Visual Studio for Mac
使用以下命令为新的 DataAnnotations 添加迁移：
dotnet ef migrations add New_DataAnnotations
dotnet ef database update
dotnet ef database update 运行 New_DataAnnotations 类的 Up 方法。
检查 Up 方法：
public partial class New_DataAnnotations : Migration
    /// <inheritdoc />
    protected override void Up(MigrationBuilder migrationBuilder)
        migrationBuilder.AlterColumn<string>(
            name: "Title",
            table: "Movie",
            type: "nvarchar(60)",
            maxLength: 60,
            nullable: false,
            oldClrType: typeof(string),
            oldType: "nvarchar(max)");
        migrationBuilder.AlterColumn<string>(
            name: "Rating",
            table: "Movie",
            type: "nvarchar(5)",
            maxLength: 5,
            nullable: false,
            oldClrType: typeof(string),
            oldType: "nvarchar(max)");
        migrationBuilder.AlterColumn<string>(
            name: "Genre",
            table: "Movie",
            type: "nvarchar(30)",
            maxLength: 30,
            nullable: false,
            oldClrType: typeof(string),
            oldType: "nvarchar(max)");
更新的 Movie 表具有以下架构：
CREATE TABLE [dbo].[Movie] (
    [ID]          INT             IDENTITY (1, 1) NOT NULL,
    [Title]       NVARCHAR (60)   NOT NULL,
    [ReleaseDate] DATETIME2 (7)   NOT NULL,
    [Genre]       NVARCHAR (30)   NOT NULL,
    [Price]       DECIMAL (18, 2) NOT NULL,
    [Rating]      NVARCHAR (5)    NOT NULL,
    CONSTRAINT [PK_Movie] PRIMARY KEY CLUSTERED ([ID] ASC)
发布到 Azure
若要了解如何部署到 Azure，请参阅教程：使用 SQL 数据库在 Azure 中生成 ASP.NET Core 应用。
感谢读完这篇 Razor Pages 简介。 Razor Pages 和 EF Core 入门是本教程的优选后续教程。
ASP.NET Core 表单中的标记帮助程序
ASP.NET Core 全球化和本地化
ASP.NET Core 中的标记帮助程序
在 ASP.NET Core 中创作标记帮助程序
上一篇：添加新字段
本部分中向 Movie 模型添加了验证逻辑。 每当用户创建或编辑电影时，都会强制执行验证规则。
软件开发的一个关键原则被称为 DRY（即“不要自我重复”）  。 Razor 页面鼓励进行仅指定一次功能的开发，且功能在整个应用中反映。 DRY 可以帮助：
减少应用中的代码量。
使代码更加不易出错，且更易于测试和维护。
Razor 页面和实体框架提供的验证支持是 DRY 原则的极佳示例：
验证规则在模型类中的某处以声明方式指定。
规则在应用的所有位置强制执行。
将验证规则添加到电影模型
System.ComponentModel.DataAnnotations 命名空间提供以下内容：
一组内置验证特性，可通过声明方式应用于类或属性。
[DataType] 等格式特性，这些特性可帮助进行格式设置，但不提供任何验证。
更新 Movie 类以使用内置的 [Required]、[StringLength]、[RegularExpression] 和 [Range] 验证特性。
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace RazorPagesMovie.Models;
public class Movie
    public int Id { get; set; }
    [StringLength(60, MinimumLength = 3)]
    [Required]
    public string Title { get; set; } = string.Empty;
    // [Display(Name = "Release Date")]
    [DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    [Range(1, 100)]
    [DataType(DataType.Currency)]
    [Column(TypeName = "decimal(18, 2)")]
    public decimal Price { get; set; }
    [RegularExpression(@"^[A-Z]+[a-zA-Z\s]*$")]
    [Required]
    [StringLength(30)]
    public string Genre { get; set; } = string.Empty;
    [RegularExpression(@"^[A-Z]+[a-zA-Z0-9""'\s-]*$")]
    [StringLength(5)]
    [Required]
    public string Rating { get; set; } = string.Empty;
验证特性指定要对应用这些特性的模型属性强制执行的行为：
[Required] 和 [MinimumLength] 特性指示属性必须具有一个值。 不阻止用户输入空格来满足此验证。
[RegularExpression] 特性用于限制可输入的字符。 在上述代码中，Genre：
只能使用字母。
第一个字母必须为大写。 允许使用空格，但不允许使用数字和特殊字符。
RegularExpression Rating：
要求第一个字符为大写字母。
允许在后续空格中使用特殊字符和数字。 “PG-13”对“分级”有效，但对于“Genre”无效。
[Range] 特性将值限制在指定的范围内。
[StringLength] 特性可以设置字符串属性的最大长度，以及可选的最小长度。
从本质上来说，需要值类型（如 decimal、int、float、DateTime），但不需要 [Required] 特性。
上述验证规则用于进行演示，它们并不是适用于生产系统的最佳规则。 例如，前面的规则会阻止用户仅使用两个字符输入一部电影，并且不允许 Genre 中有特殊字符。
让 ASP.NET Core 强制自动执行验证规则有助于：
提升应用的可靠性。
减少将无效数据保存到数据库的几率。
Razor 页面中的验证错误 UI
运行应用并导航到“页面/电影”。
选择“新建”链接。 使用无效值填写表单。 当 jQuery 客户端验证检测到错误时，会显示一条错误消息。
可能无法在小数字段中输入十进制逗号。 若要使 jQuery 验证支持使用逗号（“,”）表示小数点的的非英语区域设置，以及支持非美国英语日期格式，必须执行使应用全球化的步骤。 有关添加十进制逗号的说明，请参阅此 GitHub 注释 4076。
请注意表单如何自动呈现每个包含无效值的字段中的验证错误消息。 客户端（使用 JavaScript 和 jQuery）和服务器端（若用户禁用 JavaScript）都必定会遇到这些错误。
一项重要优势是，无需在“创建”或“编辑”页面中更改代码。 在模型应用数据注释后，即已启用验证 UI。 本教程中创建的 Razor 页面自动选取了验证规则（使用 Movie 模型类的属性上的验证特性）。 使用“编辑”页面测试验证后，即已应用相同验证。
存在客户端验证错误时，不会将表单数据发布到服务器。 请通过以下一种或多种方法验证是否未发布表单数据：
在 OnPostAsync 方法中放置一个断点。 通过选择“创建”或“保存”来提交表单 。 从未命中断点。
使用 Fiddler 工具。
使用浏览器开发人员工具监视网络流量。
服务器端验证
在浏览器中禁用 JavaScript 后，提交出错表单将发布到服务器。
（可选）测试服务器端验证：
在浏览器中禁用 JavaScript。 可以使用浏览器的开发人员工具禁用 JavaScript。 如果无法在此浏览器中禁用 JavaScript，请尝试其他浏览器。
在“创建”或“编辑”页面的 OnPostAsync 方法中设置断点。
提交包含无效数据的表单。
验证模型状态是否无效：
 if (!ModelState.IsValid)
    return Page();
或者可以禁用服务器上的客户端验证。
以下代码显示了之前在本教程中设定其基架的 Create.cshtml 的一部分。 “创建”和“编辑”页面使用它来实现以下操作：
显示初始表单。
在出现错误时重现显示此表单。
<form method="post">
    <div asp-validation-summary="ModelOnly" class="text-danger"></div>
    <div class="form-group">
        <label asp-for="Movie.Title" class="control-label"></label>
        <input asp-for="Movie.Title" class="form-control" />
        <span asp-validation-for="Movie.Title" class="text-danger"></span>
输入标记帮助程序使用 DataAnnotations 特性并在客户端生成 jQuery 验证所需的 HTML 特性。 验证标记帮助程序用于显示验证错误。 有关详细信息，请参阅验证。
“创建”和“编辑”页面中没有验证规则。 仅可在 Movie 类中指定验证规则和错误字符串。 这些验证规则将自动应用于编辑 Movie 模型的 Razor 页面。
需要更改验证逻辑时，也只能在该模型中更改。 将始终在整个应用中应用验证（在一处定义验证逻辑）。 单处验证有助于保持代码干净，且更易于维护和更新。
使用 DataType 特性
检查 Movie 类。 除了一组内置的验证特性，System.ComponentModel.DataAnnotations 命名空间还提供格式特性。 [DataType] 特性应用于 ReleaseDate 和 Price 属性。
// [Display(Name = "Release Date")]
[DataType(DataType.Date)]
public DateTime ReleaseDate { get; set; }
[Range(1, 100)]
[DataType(DataType.Currency)]
[Column(TypeName = "decimal(18, 2)")]
public decimal Price { get; set; }
[DataType] 特性提供以下内容：
提供提示，供视图引擎设置数据的格式。
提供属性，例如 URL 的 <a> 以及电子邮件的 <a href="mailto:EmailAddress.com">。
使用 [RegularExpression] 特性验证数据的格式。 [DataType] 属性用于指定比数据库内部类型更具体的数据类型。 [DataType] 特性不是验证特性。 示例应用中仅显示日期，不显示时间。
DataType 枚举提供多种数据类型，如 Date、Time、PhoneNumber、Currency、EmailAddress 等。
[DataType] 特性：
可以使应用自动提供类型特定的功能。 例如，可为 DataType.EmailAddress 创建 mailto: 链接。
可在支持 HTML5 的浏览器中提供 DataType.Date 日期选择器。
发出 HTML 5 data-（读作 data dash）特性供 HTML 5 浏览器使用。
不提供任何验证。
DataType.Date 不指定显示日期的格式。 默认情况下，数据字段根据基于服务器的 CultureInfo 的默认格式进行显示。
要使 Entity Framework Core 能将 Price 正确地映射到数据库中的货币，则必须使用 [Column(TypeName = "decimal(18, 2)")] 数据注释。 有关详细信息，请参阅数据类型。
[DisplayFormat] 特性用于显式指定日期格式：
[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
public DateTime ReleaseDate { get; set; }
ApplyFormatInEditMode 设置用于指定在显示值进行编辑时将应用格式。 某些字段可能不需要此行为。 例如，在货币值中，可能不希望编辑 UI 中存在货币符号。
可单独使用 [DisplayFormat] 特性，但通常建议使用 [DataType] 特性。 [DataType] 特性按照数据在屏幕上的呈现方式传达数据的语义。 [DataType] 特性可提供 [DisplayFormat] 所不具有的以下优点：
浏览器可启用 HTML5 功能（例如显示日历控件、区域设置适用的货币符号、电子邮件链接等）。
默认情况下，浏览器将根据区域设置采用正确的格式呈现数据。
借助 [DataType] 特性，ASP.NET Core 框架可选择适当的字段模板来呈现数据。 单独使用时，DisplayFormat 特性将使用字符串模板。
注意：jQuery 验证不适用于 [Range] 特性和 DateTime。 例如，以下代码将始终显示客户端验证错误，即便日期在指定的范围内：
[Range(typeof(DateTime), "1/1/1966", "1/1/2020")]
最佳做法是避免在模型中编译固定日期，因此不推荐使用 [Range] 特性和 DateTime。 使用配置指定日期范围和其他经常会更改的值，而不是在代码中指定它们。
以下代码显示组合在一行上的特性：
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace RazorPagesMovie.Models;
public class Movie
    public int Id { get; set; }
    [StringLength(60, MinimumLength = 3)]
    public string Title { get; set; } = string.Empty;
    [Display(Name = "Release Date"), DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    [RegularExpression(@"^[A-Z]+[a-zA-Z\s]*$"), Required, StringLength(30)]
    public string Genre { get; set; } = string.Empty;
    [Range(1, 100), DataType(DataType.Currency)]
    [Column(TypeName = "decimal(18, 2)")]
    public decimal Price { get; set; }
    [RegularExpression(@"^[A-Z]+[a-zA-Z0-9""'\s-]*$"), StringLength(5)]
    public string Rating { get; set; } = string.Empty;
Razor Pages 和 EF Core 入门显示了 Razor Pages 的高级 EF Core 操作。
应用于类的 DataAnnotations 会更改架构。 例如，应用于 Title 字段的 DataAnnotations 会：
[StringLength(60, MinimumLength = 3)]
[Required]
public string Title { get; set; } = string.Empty;
将字符数限制为 60。
不允许使用 null 值。
Movie 表当前具有以下架构：
CREATE TABLE [dbo].[Movie] (
    [ID]          INT             IDENTITY (1, 1) NOT NULL,
    [Title]       NVARCHAR (MAX)  NULL,
    [ReleaseDate] DATETIME2 (7)   NOT NULL,
    [Genre]       NVARCHAR (MAX)  NULL,
    [Price]       DECIMAL (18, 2) NOT NULL,
    [Rating]      NVARCHAR (MAX)  NULL,
    CONSTRAINT [PK_Movie] PRIMARY KEY CLUSTERED ([ID] ASC)
前面的架构更改不会导致 EF 引发异常。 不过，请创建迁移，使架构与模型保持一致。
Visual Studio
Visual Studio Code / Visual Studio for Mac
使用以下命令为新的 DataAnnotations 添加迁移：
dotnet ef migrations add New_DataAnnotations
dotnet ef database update
dotnet ef database update 运行 New_DataAnnotations 类的 Up 方法。
检查 Up 方法：
public partial class NewDataAnnotations : Migration
    /// <inheritdoc />
    protected override void Up(MigrationBuilder migrationBuilder)
        migrationBuilder.AlterColumn<string>(
            name: "Title",
            table: "Movie",
            type: "nvarchar(60)",
            maxLength: 60,
            nullable: false,
            oldClrType: typeof(string),
            oldType: "nvarchar(max)");
        migrationBuilder.AlterColumn<string>(
            name: "Rating",
            table: "Movie",
            type: "nvarchar(5)",
            maxLength: 5,
            nullable: false,
            oldClrType: typeof(string),
            oldType: "nvarchar(max)");
        migrationBuilder.AlterColumn<string>(
            name: "Genre",
            table: "Movie",
            type: "nvarchar(30)",
            maxLength: 30,
            nullable: false,
            oldClrType: typeof(string),
            oldType: "nvarchar(max)");
更新的 Movie 表具有以下架构：




    

CREATE TABLE [dbo].[Movie] (
    [ID]          INT             IDENTITY (1, 1) NOT NULL,
    [Title]       NVARCHAR (60)   NOT NULL,
    [ReleaseDate] DATETIME2 (7)   NOT NULL,
    [Genre]       NVARCHAR (30)   NOT NULL,
    [Price]       DECIMAL (18, 2) NOT NULL,
    [Rating]      NVARCHAR (5)    NOT NULL,
    CONSTRAINT [PK_Movie] PRIMARY KEY CLUSTERED ([ID] ASC)
发布到 Azure
若要了解如何部署到 Azure，请参阅教程：使用 SQL 数据库在 Azure 中生成 ASP.NET Core 应用。
感谢读完这篇 Razor Pages 简介。 Razor Pages 和 EF Core 入门是本教程的优选后续教程。
ASP.NET Core 表单中的标记帮助程序
ASP.NET Core 全球化和本地化
ASP.NET Core 中的标记帮助程序
在 ASP.NET Core 中创作标记帮助程序
上一篇：添加新字段
本部分中向 Movie 模型添加了验证逻辑。 每当用户创建或编辑电影时，都会强制执行验证规则。
软件开发的一个关键原则被称为 DRY（即“不要自我重复”）  。 Razor 页面鼓励进行仅指定一次功能的开发，且功能在整个应用中反映。 DRY 可以帮助：
减少应用中的代码量。
使代码更加不易出错，且更易于测试和维护。
Razor 页面和实体框架提供的验证支持是 DRY 原则的极佳示例：
验证规则在模型类中的某处以声明方式指定。
规则在应用的所有位置强制执行。
将验证规则添加到电影模型
System.ComponentModel.DataAnnotations 命名空间提供以下内容：
一组内置验证特性，可通过声明方式应用于类或属性。
[DataType] 等格式特性，这些特性可帮助进行格式设置，但不提供任何验证。
更新 Movie 类以使用内置的 [Required]、[StringLength]、[RegularExpression] 和 [Range] 验证特性。
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace RazorPagesMovie.Models
    public class Movie
        public int ID { get; set; }
        [StringLength(60, MinimumLength = 3)]
        [Required]
        public string Title { get; set; } = string.Empty;
        [Display(Name = "Release Date")]
        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        [Range(1, 100)]
        [DataType(DataType.Currency)]
        [Column(TypeName = "decimal(18, 2)")]
        public decimal Price { get; set; }
        [RegularExpression(@"^[A-Z]+[a-zA-Z\s]*$")]
        [Required]
        [StringLength(30)]
        public string Genre { get; set; } = string.Empty;
        [RegularExpression(@"^[A-Z]+[a-zA-Z0-9""'\s-]*$")]
        [StringLength(5)]
        [Required]
        public string Rating { get; set; } = string.Empty;
验证特性指定要对应用这些特性的模型属性强制执行的行为：
[Required] 和 [MinimumLength] 特性指示属性必须具有一个值。 不阻止用户输入空格来满足此验证。
[RegularExpression] 特性用于限制可输入的字符。 在上述代码中，Genre：
只能使用字母。
第一个字母必须为大写。 允许使用空格，但不允许使用数字和特殊字符。
RegularExpression Rating：
要求第一个字符为大写字母。
允许在后续空格中使用特殊字符和数字。 “PG-13”对“分级”有效，但对于“Genre”无效。
[Range] 特性将值限制在指定的范围内。
[StringLength] 特性可以设置字符串属性的最大长度，以及可选的最小长度。
从本质上来说，需要值类型（如 decimal、int、float、DateTime），但不需要 [Required] 特性。
上述验证规则用于进行演示，它们并不是适用于生产系统的最佳规则。 例如，前面的规则会阻止用户仅使用两个字符输入一部电影，并且不允许 Genre 中有特殊字符。
让 ASP.NET Core 强制自动执行验证规则有助于：
提升应用的可靠性。
减少将无效数据保存到数据库的几率。
Razor 页面中的验证错误 UI
运行应用并导航到“页面/电影”。
选择“新建”链接。 使用无效值填写表单。 当 jQuery 客户端验证检测到错误时，会显示一条错误消息。
可能无法在小数字段中输入十进制逗号。 若要使 jQuery 验证支持使用逗号（“,”）表示小数点的的非英语区域设置，以及支持非美国英语日期格式，必须执行使应用全球化的步骤。 有关添加十进制逗号的说明，请参阅此 GitHub 注释 4076。
请注意表单如何自动呈现每个包含无效值的字段中的验证错误消息。 客户端（使用 JavaScript 和 jQuery）和服务器端（若用户禁用 JavaScript）都必定会遇到这些错误。
一项重要优势是，无需在“创建”或“编辑”页面中更改代码。 在模型应用数据注释后，即已启用验证 UI。 本教程中创建的 Razor 页面自动选取了验证规则（使用 Movie 模型类的属性上的验证特性）。 使用“编辑”页面测试验证后，即已应用相同验证。
存在客户端验证错误时，不会将表单数据发布到服务器。 请通过以下一种或多种方法验证是否未发布表单数据：
在 OnPostAsync 方法中放置一个断点。 通过选择“创建”或“保存”来提交表单 。 从未命中断点。
使用 Fiddler 工具。
使用浏览器开发人员工具监视网络流量。
服务器端验证
在浏览器中禁用 JavaScript 后，提交出错表单将发布到服务器。
（可选）测试服务器端验证：
在浏览器中禁用 JavaScript。 可以使用浏览器的开发人员工具禁用 JavaScript。 如果无法在浏览器中禁用 JavaScript，请尝试其他浏览器。
在“创建”或“编辑”页面的 OnPostAsync 方法中设置断点。
提交包含无效数据的表单。
验证模型状态是否无效：
 if (!ModelState.IsValid)
    return Page();
或者可以禁用服务器上的客户端验证。
以下代码显示了之前在本教程中设定其基架的 Create.cshtml 的一部分。 “创建”和“编辑”页面使用它来实现以下操作：
显示初始表单。
在出现错误时重现显示此表单。
<form method="post">
    <div asp-validation-summary="ModelOnly" class="text-danger"></div>
    <div class="form-group">
        <label asp-for="Movie.Title" class="control-label"></label>
        <input asp-for="Movie.Title" class="form-control" />
        <span asp-validation-for="Movie.Title" class="text-danger"></span>
输入标记帮助程序使用 DataAnnotations 特性并在客户端生成 jQuery 验证所需的 HTML 特性。 验证标记帮助程序用于显示验证错误。 有关详细信息，请参阅验证。
“创建”和“编辑”页面中没有验证规则。 仅可在 Movie 类中指定验证规则和错误字符串。 这些验证规则将自动应用于编辑 Movie 模型的 Razor 页面。
需要更改验证逻辑时，也只能在该模型中更改。 将始终在整个应用程序中应用验证（在一处定义验证逻辑）。 单处验证有助于保持代码干净，且更易于维护和更新。
使用 DataType 特性
检查 Movie 类。 除了一组内置的验证特性，System.ComponentModel.DataAnnotations 命名空间还提供格式特性。 [DataType] 特性应用于 ReleaseDate 和 Price 属性。
[Display(Name = "Release Date")]
[DataType(DataType.Date)]
public DateTime ReleaseDate { get; set; }
[Range(1, 100)]
[DataType(DataType.Currency)]
[Column(TypeName = "decimal(18, 2)")]
public decimal Price { get; set; }
[DataType] 特性提供以下内容：
提供提示，供视图引擎设置数据的格式。
提供属性，例如 URL 的 <a> 以及电子邮件的 <a href="mailto:EmailAddress.com">。
使用 [RegularExpression] 特性验证数据的格式。 [DataType] 属性用于指定比数据库内部类型更具体的数据类型。 [DataType] 特性不是验证特性。 示例应用程序中仅显示日期，不显示时间。
DataType 枚举提供多种数据类型，如 Date、Time、PhoneNumber、Currency、EmailAddress 等。
[DataType] 特性：
可以使应用程序自动提供类型特定的功能。 例如，可为 DataType.EmailAddress 创建 mailto: 链接。
可在支持 HTML5 的浏览器中提供 DataType.Date 日期选择器。
发出 HTML 5 data-（读作 data dash）特性供 HTML 5 浏览器使用。
不提供任何验证。
DataType.Date 不指定显示日期的格式。 默认情况下，数据字段根据基于服务器的 CultureInfo 的默认格式进行显示。
要使 Entity Framework Core 能将 Price 正确地映射到数据库中的货币，则必须使用 [Column(TypeName = "decimal(18, 2)")] 数据注释。 有关详细信息，请参阅数据类型。
[DisplayFormat] 特性用于显式指定日期格式：
[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
public DateTime ReleaseDate { get; set; }
ApplyFormatInEditMode 设置用于指定在显示值进行编辑时将应用格式。 某些字段可能不需要此行为。 例如，在货币值中，可能不希望编辑 UI 中存在货币符号。
可单独使用 [DisplayFormat] 特性，但通常建议使用 [DataType] 特性。 [DataType] 特性按照数据在屏幕上的呈现方式传达数据的语义。 [DataType] 特性可提供 [DisplayFormat] 所不具有的以下优点：
浏览器可启用 HTML5 功能（例如显示日历控件、区域设置适用的货币符号、电子邮件链接等）。
默认情况下，浏览器将根据区域设置采用正确的格式呈现数据。
借助 [DataType] 特性，ASP.NET Core 框架可选择适当的字段模板来呈现数据。 单独使用时，DisplayFormat 特性将使用字符串模板。
注意：jQuery 验证不适用于 [Range] 特性和 DateTime。 例如，以下代码将始终显示客户端验证错误，即便日期在指定的范围内：
[Range(typeof(DateTime), "1/1/1966", "1/1/2020")]
最佳做法是避免在模型中编译固定日期，因此不推荐使用 [Range] 特性和 DateTime。 使用配置指定日期范围和其他经常会更改的值，而不是在代码中指定它们。
以下代码显示组合在一行上的特性：
using System;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace RazorPagesMovie.Models
    public class Movie
        public int ID { get; set; }
        [StringLength(60, MinimumLength = 3)]
        public string Title { get; set; } = string.Empty;
        [Display(Name = "Release Date"), DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        [RegularExpression(@"^[A-Z]+[a-zA-Z\s]*$"), Required, StringLength(30)]
        public string Genre { get; set; } = string.Empty;
        [Range(1, 100), DataType(DataType.Currency)]
        [Column(TypeName = "decimal(18, 2)")]
        public decimal Price { get; set; }
        [RegularExpression(@"^[A-Z]+[a-zA-Z0-9""'\s-]*$"), StringLength(5)]
        public string Rating { get; set; } = string.Empty;
Razor Pages 和 EF Core 入门显示了 Razor Pages 的高级 EF Core 操作。
应用于类的 DataAnnotations 会更改架构。 例如，应用于 Title 字段的 DataAnnotations 会：
[StringLength(60, MinimumLength = 3)]
[Required]
public string Title { get; set; } = string.Empty;
将字符数限制为 60。
不允许使用 null 值。
Movie 表当前具有以下架构：
CREATE TABLE [dbo].[Movie] (
    [ID]          INT             IDENTITY (1, 1) NOT NULL,
    [Title]       NVARCHAR (MAX)  NULL,
    [ReleaseDate] DATETIME2 (7)   NOT NULL,
    [Genre]       NVARCHAR (MAX)  NULL,
    [Price]       DECIMAL (18, 2) NOT NULL,
    [Rating]      NVARCHAR (MAX)  NULL,
    CONSTRAINT [PK_Movie] PRIMARY KEY CLUSTERED ([ID] ASC)
前面的架构更改不会导致 EF 引发异常。 不过，请创建迁移，使架构与模型保持一致。
Visual Studio
Visual Studio Code / Visual Studio for Mac
使用以下命令为新的 DataAnnotations 添加迁移：
dotnet ef migrations add New_DataAnnotations
dotnet ef database update
dotnet ef database update 运行 New_DataAnnotations 类的 Up 方法。
检查 Up 方法：
public partial class New_DataAnnotations : Migration
    protected override void Up(MigrationBuilder migrationBuilder)
        migrationBuilder.AlterColumn<string>(
            name: "Title",
            table: "Movie",
            type: "nvarchar(60)",
            maxLength: 60,
            nullable: false,
            oldClrType: typeof(string),
            oldType: "nvarchar(max)");
        migrationBuilder.AlterColumn<string>(
            name: "Rating",
            table: "Movie",
            type: "nvarchar(5)",
            maxLength: 5,
            nullable: false,
            oldClrType: typeof(string),
            oldType: "nvarchar(max)");
        migrationBuilder.AlterColumn<string>(
            name: "Genre",
            table: "Movie",
            type: "nvarchar(30)",
            maxLength: 30,
            nullable: false,
            oldClrType: typeof(string),
            oldType: "nvarchar(max)");
更新的 Movie 表具有以下架构：
CREATE TABLE [dbo].[Movie] (
    [ID]          INT             IDENTITY (1, 1) NOT NULL,
    [Title]       NVARCHAR (60)   NOT NULL,
    [ReleaseDate] DATETIME2 (7)   NOT NULL,
    [Genre]       NVARCHAR (30)   NOT NULL,
    [Price]       DECIMAL (18, 2) NOT NULL,
    [Rating]      NVARCHAR (5)    NOT NULL,
    CONSTRAINT [PK_Movie] PRIMARY KEY CLUSTERED ([ID] ASC)
发布到 Azure
若要了解如何部署到 Azure，请参阅教程：使用 SQL 数据库在 Azure 中生成 ASP.NET Core 应用。
感谢读完这篇 Razor Pages 简介。 Razor Pages 和 EF Core 入门是本教程的优选后续教程。
ASP.NET Core 表单中的标记帮助程序
ASP.NET Core 全球化和本地化
ASP.NET Core 中的标记帮助程序
在 ASP.NET Core 中创作标记帮助程序
上一篇：添加新字段
本部分中向 Movie 模型添加了验证逻辑。 每当用户创建或编辑电影时，都会强制执行验证规则。
软件开发的一个关键原则被称为 DRY（即“不要自我重复”）  。 Razor 页面鼓励进行仅指定一次功能的开发，且功能在整个应用中反映。 DRY 可以帮助：
减少应用中的代码量。
使代码更加不易出错，且更易于测试和维护。
Razor 页面和实体框架提供的验证支持是 DRY 原则的极佳示例：
验证规则在模型类中的某处以声明方式指定。
规则在应用的所有位置强制执行。
将验证规则添加到电影模型
DataAnnotations 命名空间提供以下内容：
一组内置验证特性，可通过声明方式应用于类或属性。
[DataType] 等格式特性，这些特性可帮助进行格式设置，但不提供任何验证。
更新 Movie 类以使用内置的 [Required]、[StringLength]、[RegularExpression] 和 [Range] 验证特性。
using System;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace RazorPagesMovie.Models
    public class Movie
        public int ID { get; set; }
        [StringLength(60, MinimumLength = 3)]
        [Required]
        public string Title { get; set; }
        [Display(Name = "Release Date")]
        [DataType(DataType.Date)]
        public DateTime ReleaseDate { get; set; }
        [Range(1, 100)]
        [DataType(DataType.Currency)]
        [Column(TypeName = "decimal(18, 2)")]
        public decimal Price { get; set; }
        [RegularExpression(@"^[A-Z]+[a-zA-Z\s]*$")]
        [Required]
        [StringLength(30)]
        public string Genre { get; set; }
        [RegularExpression(@"^[A-Z]+[a-zA-Z0-9""'\s-]*$")]
        [StringLength(5)]
        [Required]
        public string Rating { get; set; }
验证特性指定要对应用这些特性的模型属性强制执行的行为：
[Required] 和 [MinimumLength] 特性指示属性必须具有一个值。 不阻止用户输入空格来满足此验证。
[RegularExpression] 特性用于限制可输入的字符。 在上述代码中，Genre：
只能使用字母。
第一个字母必须为大写。 允许使用空格，但不允许使用数字和特殊字符。
RegularExpression Rating：
要求第一个字符为大写字母。
允许在后续空格中使用特殊字符和数字。 “PG-13”对“分级”有效，但对于“Genre”无效。
[Range] 特性将值限制在指定的范围内。
[StringLength] 特性可以设置字符串属性的最大长度，以及可选的最小长度。
从本质上来说，需要值类型（如 decimal、int、float、DateTime），但不需要 [Required] 特性。
上述验证规则用于进行演示，它们并不是适用于生产系统的最佳规则。 例如，前面的规则会阻止用户仅使用两个字符输入一部电影，并且不允许 Genre 中有特殊字符。
让 ASP.NET Core 强制自动执行验证规则有助于：
提升应用的可靠性。
减少将无效数据保存到数据库的几率。
Razor 页面中的验证错误 UI
运行应用并导航到“页面/电影”。
选择“新建”链接。 使用无效值填写表单。 当 jQuery 客户端验证检测到错误时，会显示一条错误消息。
可能无法在小数字段中输入十进制逗号。 若要使 jQuery 验证支持使用逗号（“,”）表示小数点的的非英语区域设置，以及支持非美国英语日期格式，必须执行使应用全球化的步骤。 有关添加十进制逗号的说明，请参阅此 GitHub 注释 4076。
请注意表单如何自动呈现每个包含无效值的字段中的验证错误消息。 客户端（使用 JavaScript 和 jQuery）和服务器端（若用户禁用 JavaScript）都必定会遇到这些错误。
一项重要优势是，无需在“创建”或“编辑”页面中更改代码。 在模型应用数据注释后，即已启用验证 UI。 本教程中创建的 Razor 页面自动选取了验证规则（使用 Movie 模型类的属性上的验证特性）。 使用“编辑”页面测试验证后，即已应用相同验证。
存在客户端验证错误时，不会将表单数据发布到服务器。 请通过以下一种或多种方法验证是否未发布表单数据：
在 OnPostAsync 方法中放置一个断点。 通过选择“创建”或“保存”来提交表单 。 从未命中断点。
使用 Fiddler 工具。
使用浏览器开发人员工具监视网络流量。
服务器端验证
在浏览器中禁用 JavaScript 后，提交出错表单将发布到服务器。
（可选）测试服务器端验证：
在浏览器中禁用 JavaScript。 可以使用浏览器的开发人员工具禁用 JavaScript。 如果无法在此浏览器中禁用 JavaScript，请尝试其他浏览器。
在“创建”或“编辑”页面的 OnPostAsync 方法中设置断点。
提交包含无效数据的表单。
验证模型状态是否无效：
 if (!ModelState.IsValid)
    return Page();
或者可以禁用服务器上的客户端验证。
以下代码显示了之前在本教程中设定其基架的 Create.cshtml 的一部分。 “创建”和“编辑”页面使用它来实现以下操作：
显示初始表单。
在出现错误时重现显示此表单。
<form method="post">
    <div asp-validation-summary="ModelOnly" class="text-danger"></div>
    <div class="form-group">
        <label asp-for="Movie.Title" class="control-label"></label>
        <input asp-for="Movie.Title" class="form-control" />
        <span asp-validation-for="Movie.Title" class="text-danger"></span>
输入标记帮助程序使用 DataAnnotations 特性并在客户端生成 jQuery 验证所需的 HTML 特性。 验证标记帮助程序用于显示验证错误。 有关详细信息，请参阅验证。
“创建”和“编辑”页面中没有验证规则。 仅可在 Movie 类中指定验证规则和错误字符串。 这些验证规则将自动应用于编辑 Movie 模型的 Razor 页面。
需要更改验证逻辑时，也只能在该模型中更改。 将始终在整个应用程序中应用验证（在一处定义验证逻辑）。 单处验证有助于保持代码干净，且更易于维护和更新。
使用 DataType 特性
检查 Movie 类。 除了一组内置的验证特性，System.ComponentModel.DataAnnotations 命名空间还提供格式特性。 [DataType] 特性应用于 ReleaseDate 和 Price 属性。
[Display(Name = "Release Date")]
[DataType(DataType.Date)]
public DateTime ReleaseDate { get; set; }
[Range(1, 100)]
[DataType(DataType.Currency)]
public decimal Price { get; set; }
[DataType] 特性提供以下内容：
提供提示，供视图引擎设置数据的格式。
提供属性，例如 URL 的 <a> 以及电子邮件的 <a href="mailto:EmailAddress.com">。
使用 [RegularExpression] 特性验证数据的格式。 [DataType] 属性用于指定比数据库内部类型更具体的数据类型。 [DataType] 特性不是验证特性。 示例应用程序中仅显示日期，不显示时间。
DataType 枚举提供多种数据类型，如 Date、Time、PhoneNumber、Currency、EmailAddress 等。
[DataType] 特性：
可以使应用程序自动提供类型特定的功能。 例如，可为 DataType.EmailAddress 创建 mailto: 链接。
可在支持 HTML5 的浏览器中提供 DataType.Date 日期选择器。
发出 HTML 5 data-（读作 data dash）特性供 HTML 5 浏览器使用。
不提供任何验证。
DataType.Date 不指定显示日期的格式。 默认情况下，数据字段根据基于服务器的 CultureInfo 的默认格式进行显示。
要使 Entity Framework Core 能将 Price 正确地映射到数据库中的货币，则必须使用 [Column(TypeName = "decimal(18, 2)")] 数据注释。 有关详细信息，请参阅数据类型。
[DisplayFormat] 特性用于显式指定日期格式：
[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
public DateTime ReleaseDate { get; set; }
ApplyFormatInEditMode 设置用于指定在显示值进行编辑时将应用格式。 某些字段可能不需要此行为。 例如，在货币值中，可能不希望编辑 UI 中存在货币符号。
可单独使用 [DisplayFormat] 特性，但通常建议使用 [DataType] 特性。 [DataType] 特性按照数据在屏幕上的呈现方式传达数据的语义。 [DataType] 特性可提供 [DisplayFormat] 所不具有的以下优点：
浏览器可启用 HTML5 功能（例如显示日历控件、区域设置适用的货币符号、电子邮件链接等）。
默认情况下，浏览器将根据区域设置采用正确的格式呈现数据。
借助 [DataType] 特性，ASP.NET Core 框架可选择适当的字段模板来呈现数据。 单独使用时，DisplayFormat 特性将使用字符串模板。
注意：jQuery 验证不适用于 [Range] 特性和 DateTime。 例如，以下代码将始终显示客户端验证错误，即便日期在指定的范围内：
[Range(typeof(DateTime), "1/1/1966", "1/1/2020")]
最佳做法是避免在模型中编译固定日期，因此不推荐使用 [Range] 特性和 DateTime。 使用配置指定日期范围和其他经常会更改的值，而不是在代码中指定它们。
以下代码显示组合在一行上的特性：
public class Movie
    public int ID { get; set; }
    [StringLength(60, MinimumLength = 3)]
    public string Title { get; set; }
    [Display(Name = "Release Date"), DataType(DataType.Date)]
    public DateTime ReleaseDate { get; set; }
    [RegularExpression(@"^[A-Z]+[a-zA-Z\s]*$"), Required, StringLength(30)]
    public string Genre { get; set; }
    [Range(1, 100), DataType(DataType.Currency)]
    [Column(TypeName = "decimal(18, 2)")]
    public decimal Price { get; set; }
    [RegularExpression(@"^[A-Z]+[a-zA-Z0-9""'\s-]*$"), StringLength(5)]
    public string Rating { get; set; }
Razor Pages 和 EF Core 入门显示了 Razor Pages 的高级 EF Core 操作。
应用于类的 DataAnnotations 会更改架构。 例如，应用于 Title 字段的 DataAnnotations 会：
[StringLength(60, MinimumLength = 3)]
[Required]
public string Title { get; set; }
将字符数限制为 60。
不允许使用 null 值。
Movie 表当前具有以下架构：
CREATE TABLE [dbo].[Movie] (
    [ID]          INT             IDENTITY (1, 1) NOT NULL,
    [Title]       NVARCHAR (MAX)  NULL,
    [ReleaseDate] DATETIME2 (7)   NOT NULL,
    [Genre]       NVARCHAR (MAX)  NULL,
    [Price]       DECIMAL (18, 2) NOT NULL,
    [Rating]      NVARCHAR (MAX)  NULL,
    CONSTRAINT [PK_Movie] PRIMARY KEY CLUSTERED ([ID] ASC)
前面的架构更改不会导致 EF 引发异常。 不过，请创建迁移，使架构与模型保持一致。
从“工具”菜单中，选择“NuGet 包管理器”>“包管理器控制台”。
在 PMC 中，输入以下命令：
Add-Migration New_DataAnnotations
Update-Database
Update-Database 运行 New_DataAnnotations 类的 Up 方法。 检查 Up 方法：
public partial class New_DataAnnotations : Migration
    protected override void Up(MigrationBuilder migrationBuilder)
        migrationBuilder.AlterColumn<string>(
            name: "Title",
            table: "Movie",
            maxLength: 60,
            nullable: false,
            oldClrType: typeof(string),
            oldNullable: true);
        migrationBuilder.AlterColumn<string>(
            name: "Rating",
            table: "Movie",
            maxLength: 5,
            nullable: false,
            oldClrType: typeof(string),
            oldNullable: true);
        migrationBuilder.AlterColumn<string>(
            name: "Genre",
            table: "Movie",
            maxLength: 30,
            nullable: false,
            oldClrType: typeof(string),
            oldNullable: true);
更新的 Movie 表具有以下架构：
CREATE TABLE [dbo].[Movie] (
    [ID]          INT             IDENTITY (1, 1) NOT NULL,
    [Title]       NVARCHAR (60)   NOT NULL,
    [ReleaseDate] DATETIME2 (7)   NOT NULL,
    [Genre]       NVARCHAR (30)   NOT NULL,
    [Price]       DECIMAL (18, 2) NOT NULL,
    [Rating]      NVARCHAR (5)    NOT NULL,
    CONSTRAINT [PK_Movie] PRIMARY KEY CLUSTERED ([ID] ASC)
发布到 Azure
若要了解如何部署到 Azure，请参阅教程：使用 SQL 数据库在 Azure 中生成 ASP.NET Core 应用。
感谢读完这篇 Razor Pages 简介。 Razor Pages 和 EF Core 入门是本教程的优选后续教程。
可靠的 Web 应用模式
请观看《适用于 .NET 的可靠 Web 应用模式》YouTube 视频和文章，了解如何创建新式、可靠、高性能、可测试、经济高效且可缩放的 ASP.NET Core 应用，无论是从头开始创建还是重构现有应用。

ASP.NET Core 表单中的标记帮助程序
ASP.NET Core 全球化和本地化
ASP.NET Core 中的标记帮助程序
在 ASP.NET Core 中创作标记帮助程序
上一篇：添加新字段