第 5 部分，ASP.NET Core 中的 Razor Pages 和 EF Core - 数据模型

作者：Tom Dykstra、Jeremy Likness 和 Jon P Smith

Contoso University Web 应用演示了如何使用 EF Core 和 Visual Studio 创建 Razor Pages Web 应用。 若要了解系列教程，请参阅第一个教程。

如果遇到无法解决的问题，请下载已完成的应用，然后对比该代码与按教程所创建的代码。

前面的教程介绍了由三个实体组成的基本数据模型。 本教程将演示如何：

• 添加更多实体和关系。
• 通过指定格式设置、验证和数据库映射规则来自定义数据模型。

完成的数据模型如下图所示：

以下数据库关系图是使用 Dataedo 创建的：

若要使用 Dataedo 创建数据库关系图，请执行以下操作：

• 将应用部署到 Azure
• 在计算机上下载并安装 Dataedo。
• 按照在 5 分钟内生成 Azure SQL 数据库的文档中的说明进行操作

在前面的 Dataedo 关系图中，CourseInstructor 是实体框架创建的联接表。 有关详细信息，请参阅多对多

Student 实体

将 Models/Student.cs 中的代码替换为以下代码：

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Student
    {
        public int ID { get; set; }
        [Required]
        [StringLength(50)]
        [Display(Name = "Last Name")]
        public string LastName { get; set; }
        [Required]
        [StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")]
        [Column("FirstName")]
        [Display(Name = "First Name")]
        public string FirstMidName { get; set; }
        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        [Display(Name = "Enrollment Date")]
        public DateTime EnrollmentDate { get; set; }
        [Display(Name = "Full Name")]
        public string FullName
        {
            get
            {
                return LastName + ", " + FirstMidName;
            }
        }

        public ICollection<Enrollment> Enrollments { get; set; }
    }
}

前面的代码将添加一个 FullName 属性，并将以下特性添加到现有属性：

• [DataType]
• [DisplayFormat]
• [StringLength]
• [Column]
• [Required]
• [Display]

FullName 计算属性

FullName 是计算属性，可返回通过串联两个其他属性创建的值。 无法设置 FullName，因此它只有一个 get 访问器。 数据库中不会创建任何 FullName 列。

DataType 特性

[DataType(DataType.Date)]

对于学生注册日期，目前所有页面都显示时间和日期，但只有日期是相关的。 使用数据注释特性，可更改一次代码，修复每个页面中数据的显示格式。

DataType 特性指定比数据库内部类型更具体的数据类型。 在此情况下，应仅显示日期，而不是日期加时间。 DataType 枚举提供多种数据类型，例如日期、时间、电话号码、货币、电子邮件地址等。应用还可通过 DataType 特性自动提供类型特定的功能。 例如：

• mailto: 链接将依据 DataType.EmailAddress 自动创建。
• 大多数浏览器中都提供面向 DataType.Date 的日期选择器。

DataType 特性发出 HTML 5 data-（读作 data dash）特性。 DataType 特性不提供验证。

DisplayFormat 特性

[DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]

DataType.Date 不指定显示日期的格式。 默认情况下，日期字段根据基于服务器的 CultureInfo 的默认格式进行显示。

DisplayFormat 特性用于显式指定日期格式。 ApplyFormatInEditMode 设置指定还应对编辑 UI 应用该格式设置。 某些字段不应使用 ApplyFormatInEditMode。 例如，编辑文本框中通常不应显示货币符号。

DisplayFormat 特性可由其本身使用。 搭配使用 DataType 特性和 DisplayFormat 特性通常是很好的做法。 DataType 特性按照数据在屏幕上的呈现方式传达数据的语义。 DataType 特性可提供 DisplayFormat 中所不具有的以下优点：

• 浏览器可启用 HTML5 功能。 例如，显示日历控件、区域设置适用的货币符号、电子邮件链接和客户端输入验证。
• 默认情况下，浏览器将根据区域设置采用正确的格式呈现数据。

有关详细信息，请参阅 <input> 标记帮助器文档。

StringLength 特性

[StringLength(50, ErrorMessage = "First name cannot be longer than 50 characters.")]

可使用特性指定数据验证规则和验证错误消息。 StringLength 特性指定数据字段中允许的字符的最小长度和最大长度。 显示的代码将名称限制为不超过 50 个字符。 稍后显示一个设置最小字符串长度的示例。

StringLength 特性还提供客户端和服务器端验证。 最小值对数据库架构没有任何影响。

StringLength 特性不会阻止用户在名称中输入空格。 RegularExpression 特性可用于向输入应用限制。 例如，以下代码要求第一个字符为大写，其余字符按字母顺序排列：

[RegularExpression(@"^[A-Z]+[a-zA-Z]*$")]

Visual Studio

在“SQL Server 对象资源管理器”(SSOX) 中，双击 Student 表，打开 Student 表设计器 。

上图显示 Student 表的架构。 名称字段具有类型 nvarchar(MAX)。 在本教程的后续部分创建和应用迁移时，因为字符串的长度特性，名称字段将变为 nvarchar(50)。

Visual Studio Code

使用 SQLite 工具，检查 Student 表的列定义。 名称字段具有类型 Text。 请注意，首个名称字段名为 FirstMidName。 在下一部分中，FirstMidName 将更改为 FirstName。

Column 特性

[Column("FirstName")]
public string FirstMidName { get; set; }

特性可以控制类和属性映射到数据库的方式。 在 Student 模型中，Column 特性用于将 FirstMidName 属性的名称映射到数据库中的“FirstName”。

创建数据库后，模型上的属性名将用作列名（使用 Column 特性时除外）。 Student 模型使用 FirstMidName 作为名字字段，因为该字段也可能包含中间名。

使用 [Column] 特性，数据模型中的 Student.FirstMidName 可映射到 Student 表的 FirstName 列。 添加 Column 特性后，SchoolContext 的支持模型会发生改变。 SchoolContext 的支持模型将不再与数据库匹配。 这种差异将通过在本教程后面添加迁移来解决。

Required 特性

[Required]

Required 特性使名称属性成为必填字段。 值类型（DateTime、int 和 double）等不可为 null 的类型不需要 Required 特性。 系统会将不可为 NULL 的类型自动视为必填字段。

Required 特性必须与 MinimumLength 结合使用才能强制执行 MinimumLength。

[Display(Name = "Last Name")]
[Required]
[StringLength(50, MinimumLength=2)]
public string LastName { get; set; }

MinimumLength 和 Required 允许通过空格来满足验证。 使用 RegularExpression 特性来完全控制字符串。

Display 特性

[Display(Name = "Last Name")]

Display 特性指定文本框的标题应是“名”、“姓”、“全名”和“注册日期”，默认标题没有分隔单词的空格，例如“Lastname”。

创建迁移

运行应用并转到“学生”页。 此时引发异常。 [Column] 特性导致 EF 希望查找名为 FirstName 的列，但数据库中的列名称仍为 FirstMidName。

Visual Studio

错误消息类似于以下示例：

SqlException: Invalid column name 'FirstName'.
There are pending model changes
Pending model changes are detected in the following:

SchoolContext

• 在 PMC 中，输入以下命令以创建新迁移并更新数据库：

  Add-Migration ColumnFirstName
  Update-Database
  
  

  其中的第一个命令将生成以下警告消息：

  An operation was scaffolded that may result in the loss of data.
  Please review the migration for accuracy.
  

  生成警告的原因是名称字段现已限制为 50 个字符。 如果数据库中的名称超过 50 个字符，则第 51 个字符及后面的所有字符都将丢失。

• 在 SSOX 中打开 Student 表：

  

  执行迁移前，名称列的类型为 nvarchar (MAX)。 名称列现在的类型为 nvarchar(50)。 列名已从 FirstMidName 更改为 FirstName。

Visual Studio Code

错误消息类似于以下示例：

SqliteException: SQLite Error 1: 'no such column: s.FirstName'.

• 在项目文件夹中打开命令窗口。 输入以下命令以创建新迁移并更新数据库：

  dotnet ef migrations add ColumnFirstName
  dotnet ef database update
  

• 使用 SQLite 工具检查 Student 表。 以前为 FirstMidName 的列现在为 FirstName。

• 运行应用并转到“学生”页。
• 请注意，时间和日期既未输入，也未显示。
• 选择“新建”，尝试输入不超过 50 个字符的名称。

注意

在以下部分中，在某些阶段生成应用会生成编译器错误。 说明用于指定生成应用的时间。

Instructor 实体

使用以下代码创建 Models/Instructor.cs：

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Instructor
    {
        public int ID { get; set; }

        [Required]
        [Display(Name = "Last Name")]
        [StringLength(50)]
        public string LastName { get; set; }

        [Required]
        [Column("FirstName")]
        [Display(Name = "First Name")]
        [StringLength(50)]
        public string FirstMidName { get; set; }

        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]
        [Display(Name = "Hire Date")]
        public DateTime HireDate { get; set; }

        [Display(Name = "Full Name")]
        public string FullName
        {
            get { return LastName + ", " + FirstMidName; }
        }

        public ICollection<Course> Courses { get; set; }
        public OfficeAssignment OfficeAssignment { get; set; }
    }
}

一行可包含多个特性。 可按如下方式编写 HireDate 特性：

[DataType(DataType.Date),Display(Name = "Hire Date"),DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)]

导航属性

Courses 和 OfficeAssignment 是导航属性。

一名讲师可以教授任意数量的课程，因此 Courses 定义为集合。

public ICollection<Course> Courses { get; set; }

讲师最多可以有一个办公室，因此 OfficeAssignment 属性包含一个 OfficeAssignment 实体。 如果未分配办公室，则 OfficeAssignment 为 NULL。

public OfficeAssignment OfficeAssignment { get; set; }

OfficeAssignment 实体

使用以下代码创建 Models/OfficeAssignment.cs：

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class OfficeAssignment
    {
        [Key]
        public int InstructorID { get; set; }
        [StringLength(50)]
        [Display(Name = "Office Location")]
        public string Location { get; set; }

        public Instructor Instructor { get; set; }
    }
}

Key 特性

[Key] 特性用于在属性名不是 classnameID 或 ID 时将属性标识为主键 (PK)。

Instructor 和 OfficeAssignment 实体之间存在一对零或一关系。 仅当与分配到办公室的讲师之间建立关系时才存在办公室分配。 OfficeAssignment PK 也是其到 Instructor 实体的外键 (FK)。 如果一个表中的 PK 既是另一个表中的 PK 又是 FK，则会存在一对零或一对一关系。

EF Core 无法自动将 InstructorID 识别为 OfficeAssignment 的 PK，因为 InstructorID 不遵循 ID 或 classnameID 命名约定。 因此，Key 特性用于将 InstructorID 识别为 PK：

[Key]
public int InstructorID { get; set; }

默认情况下，EF Core 将键视为非数据库生成，因为该列面向的是识别关系。 有关详细信息，请参阅 EF 密钥。

Instructor 导航属性

Instructor.OfficeAssignment 导航属性可以为 null，因为给定的讲师可能没有 OfficeAssignment 行。 一名讲师可能没有办公室分配。

OfficeAssignment.Instructor 导航属性将始终具有一个 Instructor 实体，因为外键 InstructorID 类型为 int，不可为 null 的值类型。 没有讲师则不可能存在办公室分配。

当 Instructor 实体具有相关 OfficeAssignment 实体时，每个实体都具有对其导航属性中的另一个实体的引用。

Course 实体

使用以下代码更新 Models/Course.cs：

using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Course
    {
        [DatabaseGenerated(DatabaseGeneratedOption.None)]
        [Display(Name = "Number")]
        public int CourseID { get; set; }

        [StringLength(50, MinimumLength = 3)]
        public string Title { get; set; }

        [Range(0, 5)]
        public int Credits { get; set; }

        public int DepartmentID { get; set; }

        public Department Department { get; set; }
        public ICollection<Enrollment> Enrollments { get; set; }
        public ICollection<Instructor> Instructors { get; set; }
    }
}

Course 实体具有外键 (FK) 属性 DepartmentID。 DepartmentID 指向相关的 Department 实体。 Course 实体具有 Department 导航属性。

当数据模型具有相关实体的导航属性时，EF Core 不要求此模型具有外键属性。 EF Core 可在数据库中的任何所需位置自动创建 FK。 EF Core 为自动创建的 FK 创建阴影属性。 然而，在数据模型中显式包含 FK 可使更新更简单和更高效。 例如，假设某个模型中不包含 FK 属性 DepartmentID。 当提取 Course 实体进行编辑时：

• 如果未显式加载，则 Department 属性为 null。
• 若要更新 Course 实体，则必须先提取 Department 实体。

如果数据模型中包含 FK 属性 DepartmentID，则无需在更新前提取 Department 实体。

DatabaseGenerated 特性

[DatabaseGenerated(DatabaseGeneratedOption.None)] 特性指定 PK 由应用程序提供而不是由数据库生成。

[DatabaseGenerated(DatabaseGeneratedOption.None)]
[Display(Name = "Number")]
public int CourseID { get; set; }

默认情况下，EF Core 假定 PK 值由数据库生成。 数据库生成通常是最佳方法。 Course 实体的 PK 由用户指定。 例如，对于课程编号，数学系可以使用 1000 系列的编号，英语系可以使用 2000 系列的编号。

DatabaseGenerated 特性还可用于生成默认值。 例如，数据库可以自动生成日期字段以记录数据行的创建或更新日期。 有关详细信息，请参阅生成的属性。

外键和导航属性

Course 实体中的外键 (FK) 属性和导航属性可反映以下关系：

课程将分配到一个系，因此将存在 DepartmentID FK 和 Department 导航属性。

public int DepartmentID { get; set; }
public Department Department { get; set; }

参与一门课程的学生数量不定，因此 Enrollments 导航属性是一个集合：

public ICollection<Enrollment> Enrollments { get; set; }

一门课程可能由多位讲师讲授，因此 Instructors 导航属性是一个集合：

public ICollection<Instructor> Instructors { get; set; }

Department 实体

使用以下代码创建 Models/Department.cs：

using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class Department
    {
        public int DepartmentID { get; set; }

        [StringLength(50, MinimumLength = 3)]
        public string Name { get; set; }

        [DataType(DataType.Currency)]
        [Column(TypeName = "money")]
        public decimal Budget { get; set; }

        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}",
                       ApplyFormatInEditMode = true)]
        [Display(Name = "Start Date")]
        public DateTime StartDate { get; set; }

        public int? InstructorID { get; set; }

        public Instructor Administrator { get; set; }
        public ICollection<Course> Courses { get; set; }
    }
}

Column 特性

Column 特性以前用于更改列名映射。 在 Department 实体的代码中，Column 特性用于更改 SQL 数据类型映射。 Budget 列通过数据库中的 SQL Server 货币类型进行定义：

[Column(TypeName="money")]
public decimal Budget { get; set; }

通常不需要列映射。 EF Core 基于属性的 CLR 类型选择相应的 SQL Server 数据类型。 CLR decimal 类型会映射到 SQL Server decimal 类型。 Budget 用于货币，但货币数据类型更适合货币。

外键和导航属性

FK 和导航属性可反映以下关系：

• 一个系可能有也可能没有管理员。
• 管理员始终由讲师担任。 因此，InstructorID 属性作为到 Instructor 实体的 FK 包含在其中。

导航属性名为 Administrator，但其中包含 Instructor 实体：

public int? InstructorID { get; set; }
public Instructor Administrator { get; set; }

上面代码中的 ? 指定属性可以为 NULL。

一个系可以有多门课程，因此存在 Course 导航属性：

public ICollection<Course> Courses { get; set; }

按照约定，EF Core 能针对不可为 null 的 FK 和多对多关系启用级联删除。 此默认行为可能导致形成循环级联删除规则。 循环级联删除规则会在添加迁移时引发异常。

例如，如果将 Department.InstructorID 属性定义为不可为 null，EF Core 将配置级联删除规则。 在这种情况下，指定为管理员的讲师被删除时，该学院将被删除。 在这种情况下，限制规则将更有意义。 以下 fluent API 将设置限制规则并禁用级联规则。

modelBuilder.Entity<Department>()
   .HasOne(d => d.Administrator)
   .WithMany()
   .OnDelete(DeleteBehavior.Restrict)

注册外键和导航属性

一份注册记录面向一名学生所注册的一门课程。

使用以下代码更新 Models/Enrollment.cs：

using System.ComponentModel.DataAnnotations;

namespace ContosoUniversity.Models
{
    public enum Grade
    {
        A, B, C, D, F
    }

    public class Enrollment
    {
        public int EnrollmentID { get; set; }
        public int CourseID { get; set; }
        public int StudentID { get; set; }
        [DisplayFormat(NullDisplayText = "No grade")]
        public Grade? Grade { get; set; }

        public Course Course { get; set; }
        public Student Student { get; set; }
    }
}

FK 属性和导航属性可反映以下关系：

注册记录面向一门课程，因此存在 CourseID FK 属性和 Course 导航属性：

public int CourseID { get; set; }
public Course Course { get; set; }

一份注册记录针对一名学生，因此存在 StudentID FK 属性和 Student 导航属性：

public int StudentID { get; set; }
public Student Student { get; set; }

多对多关系

Student 和 Course 实体之间存在多对多关系。 Enrollment 实体充当数据库中“具有有效负载”的多对多联接表。 具有有效负载表示 Enrollment 表除了联接表的 FK 外还包含其他数据。 在 Enrollment 实体中，除 FK 以外的其他数据是 PK 和 Grade。

下图显示这些关系在实体关系图中的外观。 （该图是使用 EF 6.x 的 EF Power Tools 生成的，教程未介绍如何创建该图。）

每条关系线的一端显示 1，另一端显示星号 (*)，这表示一对多关系。

如果 Enrollment 表不包含年级信息，则它只需包含两个 FK（CourseID 和 StudentID）。 无有效负载的多对多联接表有时称为纯联接表 (PJT)。

Instructor 和 Course 实体具有使用 PJT 的多对多关系。

更新数据库上下文

使用以下代码更新 Data/SchoolContext.cs：

using ContosoUniversity.Models;
using Microsoft.EntityFrameworkCore;

namespace ContosoUniversity.Data
{
    public class SchoolContext : DbContext
    {
        public SchoolContext(DbContextOptions<SchoolContext> options) : base(options)
        {
        }

        public DbSet<Course> Courses { get; set; }
        public DbSet<Enrollment> Enrollments { get; set; }
        public DbSet<Student> Students { get; set; }
        public DbSet<Department> Departments { get; set; }
        public DbSet<Instructor> Instructors { get; set; }
        public DbSet<OfficeAssignment> OfficeAssignments { get; set; }

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            modelBuilder.Entity<Course>().ToTable(nameof(Course))
                .HasMany(c => c.Instructors)
                .WithMany(i => i.Courses);
            modelBuilder.Entity<Student>().ToTable(nameof(Student));
            modelBuilder.Entity<Instructor>().ToTable(nameof(Instructor));
        }
    }
}

前面的代码添加新实体并配置 Instructor 和 Course 实体之间的多对多关系。

用 Fluent API 替代特性

上面代码中的 OnModelCreating 方法使用 Fluent API 配置 EF Core 行为。 API 称为“Fluent”，因为它通常在将一系列方法调用连接成单个语句后才能使用。 下面的代码是 Fluent API 的示例：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Blog>()
        .Property(b => b.Url)
        .IsRequired();
}

在本教程中，fluent API 仅用于不能通过特性完成的数据库映射。 但是，Fluent API 可以指定可通过特性完成的大多数格式设置、验证和映射规则。

MinimumLength 等特性不能通过 Fluent API 应用。 MinimumLength 不会更改架构，它仅应用最小长度验证规则。

某些开发者倾向于仅使用 Fluent API 以保持实体类的“纯净”。 特性和 Fluent API 可以相互混合。 部分配置只能通过 Fluent API 完成（例如，指定组合 PK）。 有些配置只能通过特性完成 (MinimumLength)。 使用 Fluent API 或特性的建议做法：

• 选择以下两种方法之一。
• 尽可能以前后一致的方法使用所选的方法。

本教程中使用的某些特性可用于：

• 仅限验证（例如，MinimumLength）。
• 仅限 EF Core 配置（例如，HasKey）。
• 验证和 EF Core 配置（例如，[StringLength(50)]）。

有关特性和 Fluent API 的详细信息，请参阅配置方法。

设定数据库种子

更新 Data/DbInitializer.cs 中的代码：

using ContosoUniversity.Models;
using System;
using System.Collections.Generic;
using System.Linq;

namespace ContosoUniversity.Data
{
    public static class DbInitializer
    {
        public static void Initialize(SchoolContext context)
        {
            // Look for any students.
            if (context.Students.Any())
            {
                return;   // DB has been seeded
            }

            var alexander = new Student
            {
                FirstMidName = "Carson",
                LastName = "Alexander",
                EnrollmentDate = DateTime.Parse("2016-09-01")
            };

            var alonso = new Student
            {
                FirstMidName = "Meredith",
                LastName = "Alonso",
                EnrollmentDate = DateTime.Parse("2018-09-01")
            };

            var anand = new Student
            {
                FirstMidName = "Arturo",
                LastName = "Anand",
                EnrollmentDate = DateTime.Parse("2019-09-01")
            };

            var barzdukas = new Student
            {
                FirstMidName = "Gytis",
                LastName = "Barzdukas",
                EnrollmentDate = DateTime.Parse("2018-09-01")
            };

            var li = new Student
            {
                FirstMidName = "Yan",
                LastName = "Li",
                EnrollmentDate = DateTime.Parse("2018-09-01")
            };

            var justice = new Student
            {
                FirstMidName = "Peggy",
                LastName = "Justice",
                EnrollmentDate = DateTime.Parse("2017-09-01")
            };

            var norman = new Student
            {
                FirstMidName = "Laura",
                LastName = "Norman",
                EnrollmentDate = DateTime.Parse("2019-09-01")
            };

            var olivetto = new Student
            {
                FirstMidName = "Nino",
                LastName = "Olivetto",
                EnrollmentDate = DateTime.Parse("2011-09-01")
            };

            var students = new Student[]
            {
                alexander,
                alonso,
                anand,
                barzdukas,
                li,
                justice,
                norman,
                olivetto
            };

            context.AddRange(students);

            var abercrombie = new Instructor
            {
                FirstMidName = "Kim",
                LastName = "Abercrombie",
                HireDate = DateTime.Parse("1995-03-11")
            };

            var fakhouri = new Instructor
            {
                FirstMidName = "Fadi",
                LastName = "Fakhouri",
                HireDate = DateTime.Parse("2002-07-06")
            };

            var harui = new Instructor
            {
                FirstMidName = "Roger",
                LastName = "Harui",
                HireDate = DateTime.Parse("1998-07-01")
            };

            var kapoor = new Instructor
            {
                FirstMidName = "Candace",
                LastName = "Kapoor",
                HireDate = DateTime.Parse("2001-01-15")
            };

            var zheng = new Instructor
            {
                FirstMidName = "Roger",
                LastName = "Zheng",
                HireDate = DateTime.Parse("2004-02-12")
            };

            var instructors = new Instructor[]
            {
                abercrombie,
                fakhouri,
                harui,
                kapoor,
                zheng
            };

            context.AddRange(instructors);

            var officeAssignments = new OfficeAssignment[]
            {
                new OfficeAssignment {
                    Instructor = fakhouri,
                    Location = "Smith 17" },
                new OfficeAssignment {
                    Instructor = harui,
                    Location = "Gowan 27" },
                new OfficeAssignment {
                    Instructor = kapoor,
                    Location = "Thompson 304" }
            };

            context.AddRange(officeAssignments);

            var english = new Department
            {
                Name = "English",
                Budget = 350000,
                StartDate = DateTime.Parse("2007-09-01"),
                Administrator = abercrombie
            };

            var mathematics = new Department
            {
                Name = "Mathematics",
                Budget = 100000,
                StartDate = DateTime.Parse("2007-09-01"),
                Administrator = fakhouri
            };

            var engineering = new Department
            {
                Name = "Engineering",
                Budget = 350000,
                StartDate = DateTime.Parse("2007-09-01"),
                Administrator = harui
            };

            var economics = new Department
            {
                Name = "Economics",
                Budget = 100000,
                StartDate = DateTime.Parse("2007-09-01"),
                Administrator = kapoor
            };

            var departments = new Department[]
            {
                english,
                mathematics,
                engineering,
                economics
            };

            context.AddRange(departments);

            var chemistry = new Course
            {
                CourseID = 1050,
                Title = "Chemistry",
                Credits = 3,
                Department = engineering,
                Instructors = new List<Instructor> { kapoor, harui }
            };

            var microeconomics = new Course
            {
                CourseID = 4022,
                Title = "Microeconomics",
                Credits = 3,
                Department = economics,
                Instructors = new List<Instructor> { zheng }
            };

            var macroeconmics = new Course
            {
                CourseID = 4041,
                Title = "Macroeconomics",
                Credits = 3,
                Department = economics,
                Instructors = new List<Instructor> { zheng }
            };

            var calculus = new Course
            {
                CourseID = 1045,
                Title = "Calculus",
                Credits = 4,
                Department = mathematics,
                Instructors = new List<Instructor> { fakhouri }
            };

            var trigonometry = new Course
            {
                CourseID = 3141,
                Title = "Trigonometry",
                Credits = 4,
                Department = mathematics,
                Instructors = new List<Instructor> { harui }
            };

            var composition = new Course
            {
                CourseID = 2021,
                Title = "Composition",
                Credits = 3,
                Department = english,
                Instructors = new List<Instructor> { abercrombie }
            };

            var literature = new Course
            {
                CourseID = 2042,
                Title = "Literature",
                Credits = 4,
                Department = english,
                Instructors = new List<Instructor> { abercrombie }
            };

            var courses = new Course[]
            {
                chemistry,
                microeconomics,
                macroeconmics,
                calculus,
                trigonometry,
                composition,
                literature
            };

            context.AddRange(courses);

            var enrollments = new Enrollment[]
            {
                new Enrollment {
                    Student = alexander,
                    Course = chemistry,
                    Grade = Grade.A
                },
                new Enrollment {
                    Student = alexander,
                    Course = microeconomics,
                    Grade = Grade.C
                },
                new Enrollment {
                    Student = alexander,
                    Course = macroeconmics,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = alonso,
                    Course = calculus,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = alonso,
                    Course = trigonometry,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = alonso,
                    Course = composition,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = anand,
                    Course = chemistry
                },
                new Enrollment {
                    Student = anand,
                    Course = microeconomics,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = barzdukas,
                    Course = chemistry,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = li,
                    Course = composition,
                    Grade = Grade.B
                },
                new Enrollment {
                    Student = justice,
                    Course = literature,
                    Grade = Grade.B
                }
            };

            context.AddRange(enrollments);
            context.SaveChanges();
        }
    }
}

前面的代码为新实体提供种子数据。 大多数此类代码会创建新实体对象并加载示例数据。 示例数据用于测试。

应用迁移或删除并重新创建

对于现有数据库，有两种方法可以更改数据库：

• 删除并重新创建数据库。 如果使用 SQLite，请选择此部分。
• 将迁移应用到现有数据库。 本部分的说明仅适用于 SQL Server，不适用于 SQLite。

这两个选项都适用于 SQL Server。 虽然应用迁移方法更复杂且耗时，但在实际应用和生产环境中为首选方法。

删除并重新创建数据库

若要强制 EF Core 创建新的数据库，请删除并更新该数据库：

Visual Studio

• 删除“Migrations”文件夹。
• 在“包管理器控制台”(PMC) 中运行以下命令：

Drop-Database
Add-Migration InitialCreate
Update-Database

Visual Studio Code

• 打开命令窗口并导航到项目文件夹。 项目文件夹包含 ContosoUniversity.csproj 文件。
• 删除“Migrations”文件夹。
• 运行以下命令：

dotnet ef database drop --force
dotnet ef migrations add InitialCreate
dotnet ef database update

运行应用。 运行应用后将运行 DbInitializer.Initialize 方法。 DbInitializer.Initialize 将填充新数据库。

Visual Studio

在 SSOX 中打开数据库：

• 如果之前已打开过 SSOX，请单击“刷新”按钮。
• 展开“表”节点。 随后将显示出已创建的表。

Visual Studio Code

使用 SQLite 工具检查数据库：

• 新的表和列。
• 表中设定种子的数据。

后续步骤

接下来的两个教程演示如何读取和更新相关数据。

上一个教程下一个教程