C# 实体框架方法 C# Entity Framework如何使用

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

EF Core 的 DbContext 是怎么被创建和使用的

EF Core 不是靠静态方法调用的,核心入口是继承

DbContext
的自定义类。你得先定义它,再通过依赖注入或手动 new(不推荐)来获取实例。没这个上下文,
DbSet<t></t>
就只是个空壳。

常见错误:直接 new 一个

DbContext
而没配置连接字符串或服务提供者,运行时抛
InvalidOperationException: No database provider has been configured

必须在
Program.cs
(.NET 6+)中调用
services.AddDbContext<appdbcontext>()</appdbcontext>
,并传入连接字符串和数据库提供者(如
Microsoft.EntityFrameworkCore.SqlServer
AppDbContext
构造函数应接受
DbContextOptions<appdbcontext></appdbcontext>
并传给基类,不能漏掉
: base(options)
每个 HTTP 请求建议只用一个
DbContext
实例(Scoped 生命周期),重复 new 或长期持有会导致追踪混乱和内存泄漏

DbSet 查询为什么有时不走 SQL,有时又报“无法翻译”

DbSet<t></t>
表面像集合,实际是 IQueryable —— 它延迟执行,且 EF 会尝试把 C# 表达式树翻译成 SQL。但不是所有操作都能翻译,尤其涉及本地方法、复杂对象构造或未映射属性时。

典型现象:

Where(x => x.Name.ToUpper() == "ADMIN")
在 SQLite 下可能成功,但在 SQL Server 上触发客户端评估警告;而
Where(x => MyHelper.IsSpecial(x.Id))
直接报错
System.InvalidOperationException: The LINQ expression could not be translated

优先用 EF 支持的表达式:比如
string.Equals(a, b, StringComparison.OrdinalIgnoreCase)
a.ToLower() == b.ToLower()
更易翻译
避免在查询中调用自定义方法、
new
对象(除非是匿名类型或实体映射字段)、
DateTime.Now
(改用
DateTime.UtcNow
,EF 能识别)
不确定是否可翻译?加
.AsEnumerable()
强制转为客户端执行(但会拉全表!仅调试用)

SaveChanges 和 SaveChangesAsync 的区别不只是同步异步

SaveChanges()
是同步阻塞调用,会等数据库事务提交完成才返回;
SaveChangesAsync()
是真正的异步,底层使用数据库驱动的 async I/O,不占用线程池线程。

容易踩的坑:在 ASP.NET Core 控制器里用了

SaveChanges()
却声明了
async Task<iactionresult></iactionresult>
方法,结果既没真正异步,又因未 await 导致状态机混乱或静默失败。

Web 应用一律用
await context.SaveChangesAsync()
,不要混用同步方法
事务控制要显式:用
await context.Database.BeginTransactionAsync()
,而不是靠
SaveChanges
自动开启(它只在无事务时新建)
批量插入大量数据?别循环调
Add()
+
SaveChanges()
—— 每次都开事务。改用
context.AddRange()
一次添加多个,再单次
SaveChanges

迁移(Migration)命令为什么总提示“无法访问项目”或“No migrations found”

EF Core 迁移命令(如

dotnet ef migrations add Init
)需要同时知道两个东西:实体模型在哪(
--project
)、DbContext 类型在哪(
--startup-project
)。多数失败是因为路径或程序集解析错了。

典型报错:

Unable to retrieve project metadata. Ensure it's an SDK-style project
No DbContext was found

确保当前终端目录是含
.csproj
的项目根目录;如果 DbContext 在类库,需用
--project
指向该类库,
--startup-project
指向 Web/Console 主项目
主项目必须引用 EF Core 设计时包:
Microsoft.EntityFrameworkCore.Design
(开发时必需,非运行时)
迁移文件生成后,
dotnet ef database update
才真正建表;别以为
migrations add
就完事了
dotnet ef migrations add Init --project .\MyData.dll --startup-project .\MyWebApp.csproj

EF Core 的麻烦点不在语法多难,而在它横跨了对象模型、SQL 生成、生命周期管理和工具链四层。任何一个环节断开(比如 DbContext 注册漏了、迁移没指定 startup-project、查询用了不可翻译方法),都会表现为“不工作”,但错误信息往往藏在不同位置。动手前先确认这四层是否都连上了。

相关推荐