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

来源:这里教程网 时间:2026-02-21 17:38:08 作者:

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

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

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

[Key] 标记主键,或按约定命名为
Id
ClassNameId
(如
UserId
[Required] 表示非空字段,[StringLength(50)] 控制长度 导航属性(如
public ICollection<order> Orders { get; set; }</order>
)自动映射一对多关系

示例:

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<t></t>
声明数据集:

推荐在
Program.cs
中注册上下文(.NET 6+):
builder.Services.AddDbContext<appdbcontext>(opt => opt.UseSqlServer(connectionString));</appdbcontext>
在构造函数中接收
DbContextOptions<appdbcontext></appdbcontext>
,调用基类构造器
重写
OnModelCreating
可精细配置关系、索引、种子数据等

示例节选:

public class AppDbContext : DbContext
{
    public AppDbContext(DbContextOptions<appdbcontext> options) : base(options) { }
<pre class="brush:php;toolbar:false;">public DbSet<Product> Products { get; set; }
public DbSet<Category> Categories { get; set; }
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Product>()
        .HasOne(p => p.Category)
        .WithMany(c => c.Products)
        .HasForeignKey(p => p.CategoryId);
}

}

appdbcontext>

执行基本 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 把数据库操作封装得足够简洁,又保留了扩展性。不复杂但容易忽略配置细节——比如忘记注册上下文、漏掉异步等待、或没跑迁移导致表不存在。

相关推荐