EF Core在WPF中怎么使用 EF Core与WPF集成教程

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.DependencyInjectionMicrosoft.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,注册 AppDbContextScoped(每次请求/窗口新建一次,避免多线程冲突)
  • 注册你的业务服务(如 StudentService),并在构造函数中注入 AppDbContext
  • 保存 ServiceProviderApp 实例,后续窗体可通过 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 绑定。