C# 怎么使用 Entity Framework Core 进行数据库操作_C# EF Core 数据库操作完整指南

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

使用 C# 和 Entity Framework Core(EF Core)进行数据库操作是现代 .NET 开发中的常见做法。EF Core 是一个轻量级、跨平台且功能强大的 ORM(对象关系映射)框架,能够将 C# 类映射到数据库表,并通过面向对象的方式操作数据,无需直接写 SQL 语句。

1. 安装 EF Core 及数据库提供程序

在项目中使用 EF Core 前,需先安装相关 NuGet 包。以 SQL Server 为例:

Microsoft.EntityFrameworkCore.SqlServer:SQL Server 提供程序 Microsoft.EntityFrameworkCore.Tools:支持迁移命令(如 Add-Migration)

可通过 NuGet 包管理器或 .NET CLI 安装:

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

若使用 SQLite 或 PostgreSQL,替换为对应提供程序包即可。

2. 创建实体类和 DbContext

定义与数据库表对应的 C# 类(实体类),并创建继承自 DbContext 的上下文类。

示例:用户实体类

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

创建数据库上下文:

using Microsoft.EntityFrameworkCore;

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

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)  
{  
    optionsBuilder.UseSqlServer("Your_Connection_String_Here");  
}  

}

连接字符串也可从配置文件注入,更推荐使用依赖注入方式在 Program.csStartup.cs 中配置。

3. 使用迁移(Migration)创建数据库

EF Core 支持通过代码生成数据库结构。步骤如下:

打开 Package Manager Console 或 .NET CLI 执行添加迁移命令: dotnet ef migrations add InitialCreate

该命令会根据当前 DbContext 生成迁移代码。

应用迁移,创建数据库: dotnet ef database update

此时数据库和 Users 表将被自动创建。

4. 执行增删改查(CRUD)操作

使用 DbContext 实例操作数据。

添加数据

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(); var userById = context.Users.Find(1); var query = context.Users.Where(u => u.Name.Contains("张")).ToList();

更新数据

var user = context.Users.Find(1); if (user != null) { user.Email = "newemail@example.com"; context.SaveChanges(); }

删除数据

var user = context.Users.Find(1); if (user != null) { context.Users.Remove(user); context.SaveChanges(); }

5. 高级用法提示

异步操作:推荐使用异步方法避免阻塞线程。

var users = await context.Users.ToListAsync(); await context.SaveChangesAsync();

配置模型关系:可通过 Fluent API 在 OnModelCreating 中配置外键、索引等。

protected override void OnModelCreating(ModelBuilder modelBuilder) { modelBuilder.Entity() .HasIndex(u => u.Email) .IsUnique(); }

使用依赖注入(ASP.NET Core 推荐)

builder.Services.AddDbContext(options => options.UseSqlServer(builder.Configuration.GetConnectionString("Default")));

然后在控制器或服务中通过构造函数注入 AppDbContext

基本上就这些。掌握以上内容后,你已经可以熟练使用 EF Core 进行日常数据库开发。不复杂但容易忽略的是连接字符串管理和迁移的规范使用。

相关推荐