.NET如何使用Entity Framework Core实现Code First开发_EF Core Code First开发教程

来源：这里教程网时间：2026-02-21 17:30:34 作者：

Entity Framework Core（简称 EF Core）是微软提供的轻量级、可扩展且跨平台的ORM框架，支持Code First开发模式。在Code First模式下，开发者通过编写C#类来定义数据模型，EF Core会根据这些类自动生成数据库结构，非常适合领域驱动设计和快速迭代开发。

1. 安装EF Core相关包

开始前，确保项目已安装EF Core的核心库和对应数据库的提供程序。以SQL Server为例，在.NET项目中通过NuGet安装以下包：

Microsoft.EntityFrameworkCore（核心库） Microsoft.EntityFrameworkCore.SqlServer（SQL Server提供程序） Microsoft.EntityFrameworkCore.Tools（用于迁移命令）

可通过NuGet包管理器或命令行安装：

dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.Tools

2. 定义实体模型类

创建代表数据库表的C#类。每个类对应一张表，属性对应字段。

例如，定义一个

User

类：

public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
}

EF Core默认约定：名为

Id

的属性会被识别为主键；类名复数形式作为表名（如

Users

）。

3. 创建DbContext派生类

DbContext

是EF Core的核心入口，用于管理实体集合和数据库连接。

新建一个类继承

DbContext

：

public class AppDbContext : DbContext
{
    public DbSet Users { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        optionsBuilder.UseSqlServer("Server=localhost;Database=MyAppDb;Trusted_Connection=true;TrustServerCertificate=true");
    }
}

也可以在

Program.cs

或

Startup.cs

中通过依赖注入配置连接字符串，更推荐这种方式。

4. 使用迁移（Migration）创建数据库

EF Core通过迁移将模型变更同步到数据库。

执行以下命令生成初始迁移：

dotnet ef migrations add InitialCreate

该命令会在项目中生成一个

Migrations

文件夹，包含描述数据库结构变更的代码文件。

接着应用迁移，创建数据库：

dotnet ef database update

此时，数据库

MyAppDb

会被创建，并生成

Users

表。

5. 操作数据（CRUD示例）

使用

AppDbContext

进行数据操作：

using var context = new AppDbContext();

// 添加用户
var user = new User { Name = "张三", Email = "zhangsan@example.com" };
context.Users.Add(user);
context.SaveChanges();

// 查询用户
var users = context.Users.ToList();

// 更新
user.Name = "李四";
context.SaveChanges();

// 删除
context.Users.Remove(user);
context.SaveChanges();

6. 模型进阶配置（可选）

可通过数据注解或Fluent API进一步配置模型。

使用数据注解（在类上加Attribute）：

public class User
{
    [Key]
    public int Id { get; set; }

    [Required, MaxLength(100)]
    public string Name { get; set; }

    [EmailAddress]
    public string Email { get; set; }
}

或在

OnModelCreating

中使用Fluent API：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity()
        .ToTable("Users")
        .Property(u => u.Name).IsRequired().HasMaxLength(100);
}

基本上就这些。从定义模型到操作数据，EF Core的Code First流程清晰高效。只要掌握迁移命令和上下文配置，就能快速构建数据层。实际项目中建议结合依赖注入和配置文件管理连接字符串，提升灵活性和安全性。