C#如何使用EF Core进行数据库操作 C# EF Core基础教程

13次阅读

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

C#如何使用EF Core进行数据库操作 C# EF Core基础教程

EF Core 是 .net 平台推荐的现代 ORM 框架,用它操作数据库核心就三步:定义模型、配置上下文、调用 LINQ 方法。不用写 sql 也能完成增删改查,而且天然支持异步、迁移、依赖注入等现代开发习惯。

定义实体类(你的数据模型)

每个数据库表对应一个 C# 类,用特性标注主键、外键、长度等约束:

  • [Key] 标记主键,或按约定命名为 IdClassNameId(如 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 把数据库操作封装得足够简洁,又保留了扩展性。不复杂但容易忽略配置细节——比如忘记注册上下文、漏掉异步等待、或没跑迁移导致表不存在。

text=ZqhQzanResources