一、引言
EF Core Code-First 模式是一种开发方法，在这种方法中，开发人员首先根据业务需求定义实体类，随后通过迁移（Migration）功能生成对应的数据库表结构。本文将详细介绍 EF Core Code-First 模式的核心原理及实际操作步骤。
二、EF Core Code-First 工作原理详解
2.1 模型设计：创建类并定义属性
在 Code-First 模式下，首先要根据业务需求创建模型类，这些类的属性将直接映射为数据库中的字段。例如，假设我们要创建一个表示“类别”的类：
public class Category
{
[Key] // 指定此字段为主键
public int CategoryId { get; set; } // 自动生成的主键列
[Required] // 指定此字段为非空
public string CategoryName { get; set; } // 类别名称字段
public int CategoryDisplayOrder { get; set; } // 显示顺序字段
}
上面的代码中使用了 [Key] 和 [Required] 属性，这些数据注解帮助 EF Core 将字段映射为数据库表中的主键和非空字段。
-
[Key]注解表明CategoryId是数据库中的主键列。 -
[Required]注解强制CategoryName字段不能为空。
2.2 数据库上下文类：DbContext
模型创建完成后，需要定义数据库上下文类，它是与数据库交互的桥梁。在 EF Core 中，数据库上下文类继承自 DbContext，并包含所有要映射到数据库的实体集（即数据表）。以下是 ApplicationDbContext 类的定义：
public class ApplicationDbContext : DbContext
{
public ApplicationDbContext(DbContextOptions options )
: base(options) // 调用基类构造函数
{
}
public DbSet Categories { get; set; } // 将实体类映射为数据库表
}
DbSet 表示我们将 Category 类映射为数据库中的一张表，表名将默认是复数形式，即 Categories。
2.3 种子数据（Seed Data）初始化
在有些情况下，我们需要在数据库生成时插入一些初始数据，这时可以通过 OnModelCreating 方法在数据库生成时自动添加预设数据。以下是在 ApplicationDbContext 中定义种子数据的方式：
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity().HasData( // 使用HasData方法配置种子数据
new Category { CategoryId = 1, CategoryName = "Action", CategoryDisplayOrder = 1 },
new Category { CategoryId = 2, CategoryName = "SciFi", CategoryDisplayOrder = 2 },
new Category { CategoryId = 3, CategoryName = "History", CategoryDisplayOrder = 3 }
);
}
通过 HasData 方法，EF Core 在数据库生成时会自动插入这些数据，省去了手动插入初始数据的步骤。
三、EF Core 数据库连接与迁移
3.1 数据库连接配置
在开始使用数据库前，我们需要在项目中配置数据库连接。在 Program.cs 中添加以下代码，用于定义数据库连接字符串：
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddDbContext(options =>
options.UseSqlServer( // 使用SQL Server作为数据库
builder.Configuration.GetConnectionString("DefaultConnection"))); // 从配置文件获取连接字符串
var app = builder.Build();
app.Run();
上述代码从 appsettings.json 配置文件中读取数据库连接字符串，并使用 UseSqlServer 方法指定 SQL Server 作为数据库。
3.2 添加迁移并更新数据库
完成模型和数据库上下文的定义后，下一步是将这些模型映射为数据库表结构。此过程通过迁移（Migration）工具实现。
-
添加迁移
打开 NuGet 包管理器控制台，输入以下命令以创建迁移：add-migration <迁移名称>此命令将生成一个新的迁移文件，其中包含数据库表的创建逻辑。你可以在项目中查看该文件，并确认其内容是否符合预期。
-
更新数据库
添加迁移后，使用以下命令将更改应用到数据库中：update-database这一步将根据迁移文件中的内容在数据库中生成相应的表结构。
3.3 确认数据库中的表结构
在成功运行迁移后，你可以使用 SQL Server Management Studio 或其他数据库管理工具，检查生成的表结构是否符合你的预期。例如，Categories 表应该包含 CategoryId、CategoryName 和 CategoryDisplayOrder 三个字段，并且会预填种子数据。
四、结论
EF Core Code-First 模式为开发者提供了一种灵活的数据库设计方式，使得开发人员可以从业务需求出发，先编写领域模型类，再自动生成数据库结构。通过迁移工具和种子数据功能，开发过程变得更加简单、直观。希望本文通过详细的步骤说明，能够帮助开发者更好地理解并应用 Code-First 模式。