InventorySample数据访问实战：EF Core搭配SQLite与SQL Server双数据源全解

InventorySample数据访问实战EF Core搭配SQLite与SQL Server双数据源全解【免费下载链接】InventorySampleSample UWP application for LOB scenarios项目地址: https://gitcode.com/gh_mirrors/in/InventorySampleInventorySample 是微软开源的 UWP 企业级LOB库存管理应用示例它基于Entity Framework CoreEF Core实现了一套干净利落的数据访问方案默认使用本地SQLite数据库开箱即用同时支持一键切换到SQL Server远程数据源。本文将从新手视角带你拆解这套双数据源设计的每一层实现帮助你快速掌握 EF Core 在真实业务应用中的数据访问实战。快速上手获取 InventorySample 数据访问示例如果你想在本地跑起来观察这套架构只需要 3 步克隆仓库git clone https://gitcode.com/gh_mirrors/in/InventorySample用 Visual Studio 打开解决方案 src/Inventory.sln选择 Windows 10/11 目标平台并运行Inventory.App项目应用首次启动后自带一份 SQLite 示例数据库VanArsdel.1.01.db无需任何配置即可浏览客户、订单、商品数据。整个解决方案分为 4 个项目数据访问逻辑被隔离在Inventory.Data中界面与业务分别由Inventory.App和Inventory.ViewModels承担为什么需要SQLite SQL Server双数据源对于库存这类 LOB 场景开发演示和正式部署往往面对两种完全不同的环境本地演示/离线场景不想安装数据库服务器直接读一个.db文件即可SQLite 是最佳选择企业级生产场景需要共享的 SQL Server 或 Azure SQL Database支持多用户并发。InventorySample 的做法是把数据从哪来抽象成接口把怎么用数据完全与数据库类型解耦。切换数据源就像换一个插头上层代码一行都不用改。拆解 Inventory.Data三层数据访问设计Inventory.Data 项目 是 .NET Standard 类库内部按三个层次组织详见官方文档 docs/Architecture/DataAccess.md1️⃣ Data实体模型层Data文件夹下是与数据库表一一对应的实体类例如 Customer.cs、Order.cs、Product.cs、OrderItem.cs还有记录数据库版本的 DbVersion.cs。这些模型在整个 App 中充当数据传输对象DTO与界面显示用的 Model 是分离的。2️⃣ IDataSource数据库上下文层核心接口 IDataSource.cs 暴露了所有DbSetT集合Customers、Orders、Products、OrderItems以及分类、国家、支付方式等查找表还有EntryTEntity和SaveChangesAsync两个 EF Core 关键操作。它有两个实现实现类数据库关键配置SQLiteDb.cs本地 SQLite 文件optionsBuilder.UseSqlite(_connectionString)SQLServerDb.csSQL ServeroptionsBuilder.UseSqlServer(_connectionString)两个类几乎一模一样唯一区别就是OnConfiguring里调用的 EF Core 提供程序。它们都在OnModelCreating中为OrderItem定义了复合主键OrderID OrderLine这是一个很实用的 EF Core 建模技巧。3️⃣ IDataService数据操作层接口 IDataService.cs 定义了客户、订单、订单项、商品四类数据的增删改查契约GetCustomerAsync、GetOrdersAsync、UpdateProductAsync……由 SQLiteDataService.cs 与 SQLServerDataService.cs 实现。大量通用 LINQ 查询逻辑写在抽象基类 DataServiceBase.cs 中两个具体实现只是注入不同的IDataSource上下文——这就是一次编写双端运行的关键。一键切换数据源工厂模式 配置项切换逻辑非常简洁核心在两个文件里① 配置项AppSettings.cs 用本地设置存储DataProvider枚举值SQLite/SQLServer默认 SQLite同时管理两种连接字符串SQLiteData SourceDatabase/VanArsdel.1.01.dbSQL Server 默认值Data Source.\SQLExpress;Initial CatalogVanArsdelDb;Integrated SecuritySSPI② 工厂DataServiceFactory.cs 的CreateDataService()根据AppSettings.Current.DataProvider走switch分支返回对应的数据服务实例switch (AppSettings.Current.DataProvider) { case DataProviderType.SQLite: return new SQLiteDataService(AppSettings.Current.SQLiteConnectionString); case DataProviderType.SQLServer: return new SQLServerDataService(AppSettings.Current.SQLServerConnectionString); } 工厂里还藏了一个彩蛋IsRandomErrorsEnabled开关可以随机抛出异常用于测试 Activity Log 的异常捕获链路是学习数据访问异常处理的好素材。设置页实战验证连接与自动建库在应用的Settings 页面界面定义见 SettingsView.xaml逻辑在 SettingsViewModel.cs可以完成数据源切换Local Data Provider选择本地 SQLite附带Reset data按钮可一键还原示例数据SQL Data Provider填入连接字符串后可以Validate Connection验证连接由 ValidateConnectionViewModel.cs 实现。它通过 EF Core 的IDatabaseCreator.ExistsAsync()判断库是否存在再读取DbVersion表比对版本号当前1.01分别提示连接成功/版本不匹配/库不存在三种状态Create Database自动建库由 CreateDatabaseViewModel.cs 实现。调用Database.EnsureCreatedAsync()按 EF Core 模型自动建表然后逐表把本地 SQLite样板库中的示例数据拷贝进 SQL Server进度条按表逐项推进最后写入DbVersion版本记录。这套模型即 Schema 版本校验的初始化流程正是 EF CoreCode First思想在实战中的典型应用。数据如何流进界面界面并不直接碰 EF Core而是走一条清晰的链路ViewModel → 业务服务Services→ IDataService → DbContext → 数据库例如客户详情页 CustomerDetailsViewModel.cs 通过构造函数注入 ICustomerService而 CustomerService.cs 每次操作时using (var dataService DataServiceFactory.CreateDataService())现建现用、用完即释放。业务服务同时充当DTO → 界面 Model的映射器如Customer→CustomerModel后者才实现INotifyPropertyChanged让 EF Core 实体保持无行为的纯净状态。列表数据则由VirtualCollection见 src/Inventory.App/Common/VirtualCollection/做虚拟化分页加载保证大数据量下列表流畅。新手避坑指南EF Core 数据访问 5 个要点基于这份源码总结出几条例值得记住的实战经验用using管好上下文生命周期DbContext创建即打开资源代码库统一在using块中创建并释放如 ValidateConnectionViewModel.cs上下文不是线程安全的同一实体实例不能被多个上下文同时跟踪跨线程请新建上下文只读查询加AsNoTracking()建库拷贝数据时使用见 CreateDatabaseViewModel.cs跳过变更跟踪显著提升性能DbSet访问本身不触发查询只有ToList、First等终端操作才真正执行 SQL写库统一走SaveChangesAsync配合Entry(entity).State区分 Added/Modified变更先记在ChangeTracker中提交时才落库。参考文件清单模块路径双 DbContext 实现src/Inventory.Data/DataContexts/数据服务基类与实现src/Inventory.Data/DataServices/数据源工厂DataServiceFactory.cs数据源配置AppSettings.cs连接验证 / 自动建库src/Inventory.ViewModels/ViewModels/Settings/官方数据访问文档docs/DataAccess/README.md、docs/Architecture/DataAccess.md掌握这套接口抽象上下文 工厂切换数据源 服务层映射模型的模式后你就能在自己的 .NET 应用中轻松实现 EF Core 多数据库支持——这正是 InventorySample 作为学习范本的最大价值。【免费下载链接】InventorySampleSample UWP application for LOB scenarios项目地址: https://gitcode.com/gh_mirrors/in/InventorySample创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考