EF Core 在 WPF 中需通过依赖注入管理 DbContext 生命周期,注册为 Scoped,配合异步操作与 MVVM 模式;避免 UI 线程 new Context 或同步调用,确保数据库操作 async/await 并用 ObservableCollection 绑定界面。

EF Core 在 WPF 中不是“直接嵌入”就能用的,关键在于把 EF Core 的生命周期、数据库上下文管理和 UI 线程协作理清楚。WPF 是 UI 框架,EF Core 是数据访问框架,两者职责分明,集成的核心是:**用依赖注入组织 DbContext,避免在 UI 代码里 new Context,同时注意异步操作不阻塞主线程**。
配置项目与安装必要包
确保你使用的是 .NET 6 或更高版本的 WPF .NET Core / .NET 5+ 项目(不是传统的 .NET Framework WPF)。然后通过 NuGet 安装以下包:
- Microsoft.EntityFrameworkCore(EF Core 核心)
-
对应数据库的提供程序,例如:
- MySQL → Pomelo.EntityFrameworkCore.MySql
- SQL Server → Microsoft.EntityFrameworkCore.SqlServer
- SQLite → Microsoft.EntityFrameworkCore.Sqlite
- (可选但推荐)Microsoft.Extensions.DependencyInjection 和 Microsoft.Extensions.Configuration.Json,用于 DI 和配置管理
准备配置文件和数据库上下文
在项目根目录添加 appsettings.json,设为“复制到输出目录”:
{
"ConnectionStrings": {
"DefaultConnection": "server=localhost;port=3306;database=myapp;user=root;password=123456;"
}
}
新建一个继承 DbContext 的类,比如 AppDbContext:
- 构造函数接收
DbContextOptions,不要硬编码连接字符串 - 在
OnConfiguring中只做兜底(开发调试用),正式逻辑交给 DI 注册时传入选项 - 记得定义
DbSet属性映射你的实体
在 App.xaml.cs 中配置服务容器
WPF 没有内置 DI 容器,需手动初始化。重写 OnStartup 方法:
- 用
ConfigurationBuilder加载appsettings.json - 创建
ServiceCollection,注册AppDbContext为 Scoped(每次请求/窗口新建一次,避免多线程冲突) - 注册你的业务服务(如
StudentService),并在构造函数中注入AppDbContext - 保存
ServiceProvider到App实例,后续窗体可通过Application.Current获取
⚠️ 注意:DbContext 不能注册为 Singleton,否则并发操作会出错;也不能在 UI 线程里反复 new,容易引发连接泄漏或状态混乱。
在 ViewModel 或后台代码中安全使用
推荐搭配 MVVM 模式,把数据逻辑放在 ViewModel 中:
- ViewModel 构造函数接收服务(如
IStudentService),而不是直接持有DbContext - 所有数据库操作(查询、增删改)都应标记
async,用await调用,例如await _context.Students.ToListAsync() - 更新 DataGrid 等控件时,确保集合是
ObservableCollection,且修改发生在 UI 线程(EF Core 异步方法返回后,通常已在 UI 线程,但若用了Task.Run就要Dispatcher.Invoke回切) - 增删改后调用
SaveChangesAsync(),检查返回值判断是否成功
不建议在按钮 Click 事件里直接 new DbContext 并同步执行 SaveChanges —— 会卡界面,也难测试和复用。
基本上就这些。核心就三点:配好包和连接串、用 DI 管理上下文生命周期、异步操作 + MVVM 分离关注点。不复杂但容易忽略细节,比如 Scoped 注册、async/await 配对、ObservableCollection 绑定。










