EF Core 操作数据库分三步:定义带特性标注的实体模型、继承 DbContext 并配置关系、通过 DbSet 调用 LINQ 实现 CRUD;支持异步、迁移和依赖注入,需注意注册上下文、await 异步方法及及时执行迁移。

EF Core 是 .NET 平台推荐的现代 ORM 框架,用它操作数据库核心就三步:定义模型、配置上下文、调用 LINQ 方法。不用写 SQL 也能完成增删改查,而且天然支持异步、迁移、依赖注入等现代开发习惯。
定义实体类(你的数据模型)
每个数据库表对应一个 C# 类,用特性标注主键、外键、长度等约束:
- 用 [Key] 标记主键,或按约定命名为
Id或ClassNameId(如UserId) - 用 [Required] 表示非空字段,[StringLength(50)] 控制长度
- 导航属性(如
public ICollection)自动映射一对多关系Orders { get; set; }
示例:
public class Product
{
public int Id { get; set; }
[Required, StringLength(100)]
public string Name { get; set; }
public decimal Price { get; set; }
public int CategoryId { get; set; }
public Category Category { get; set; } // 导航属性
}创建 DbContext(数据库会话中心)
继承 DbContext,重写 OnConfiguring 或通过依赖注入传入连接字符串,再用 DbSet 声明数据集:
- 推荐在
Program.cs中注册上下文(.NET 6+):builder.Services.AddDbContext(opt => opt.UseSqlServer(connectionString)); - 在构造函数中接收
DbContextOptions,调用基类构造器 - 重写
OnModelCreating可精细配置关系、索引、种子数据等
示例节选:
public class AppDbContext : DbContext
{
public AppDbContext(DbContextOptions options) : base(options) { }
public DbSet Products { get; set; }
public DbSet Categories { get; set; }
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity()
.HasOne(p => p.Category)
.WithMany(c => c.Products)
.HasForeignKey(p => p.CategoryId);
}
}
执行基本 CRUD(在服务或控制器里用)
通过依赖注入获取 AppDbContext 实例,所有操作都围绕 DbSet 展开,支持同步和异步方法:
-
查:用 LINQ 查询,
context.Products.Where(p => p.Price > 100).ToList() 或异步版 .ToListAsync()
-
增:调用
context.Products.Add(newProduct),再 SaveChangesAsync()
-
改:先查出实体 → 修改属性 →
SaveChangesAsync()(EF 自动跟踪变更)
-
删:用
context.Products.Remove(product) 或 .RemoveRange(...),再保存
注意:修改单个字段可避免全量查询,用 context.Entry(entity).Property(e => e.Name).IsModified = true;
用迁移管理数据库结构(开发阶段必备)
EF Core 能根据模型变化生成数据库脚本,避免手动改库:
- 安装
Microsoft.EntityFrameworkCore.Tools NuGet 包
- 命令行执行:
dotnet ef migrations add Init(生成迁移文件),dotnet ef database update(应用到数据库)
- 每次改了模型类,就加一次新迁移,团队共享迁移文件即可保持结构一致
迁移本质是代码化的数据库版本控制,比直接运行 SQL 更安全可控。
基本上就这些。EF Core 把数据库操作封装得足够简洁,又保留了扩展性。不复杂但容易忽略配置细节——比如忘记注册上下文、漏掉异步等待、或没跑迁移导致表不存在。










