Crping.EFCore 7.4.0

Crping.EFCore

基于 EntityFramework Core 的数据库操作工具包基础类，支持读写分离，支持MySQL、SQL Server等，包含WebApi的增、删、改、查、分页等常用方法实现！

版本更新说明

---

7.4.0

2026年8月3日 星期一

与 Crping.EFCore.Common / Crping.EFCore.Controller 同步升至 7.4.0

破坏性变更 — 枚举重命名

• DalResult 枚举重命名为 ResultCode，全项目 163 处引用更新
• 文件从 DalResult.cs 改为 ResultCode.cs

迁移指南

• 将代码中所有 DalResult 替换为 ResultCode

---

7.3.0

2026年7月30日 星期三

与 Crping.EFCore.Common / Crping.EFCore.Controller 同步升至 7.3.0

破坏性变更 — 时间类型从 DateTime 改为 DateTimeOffset

• 所有 BLL 层的 DateTime.Now 改为 DateTimeOffset.Now（WebApiBaseBLL.cs、WebApiBaseBLL.Update.cs、WebApiBaseBLL.Delete.cs）
• 统计查询 DateTime.Today 改为 DateTimeOffset.Now（WebApiBaseBLL.Statistics.cs）
• EntityHelper.DefaultTime 类型从 DateTime 改为 DateTimeOffset
• EntityHelper.GenerateId() 参数 fixedTime 从 DateTime? 改为 DateTimeOffset?
• Utils.CustomTimestamp() 参数 fixedTime 从 DateTime? 改为 DateTimeOffset?
• EFCoreExt.UpdateTo() 中 DateTime.Now 改为 DateTimeOffset.Now

迁移指南

• 将实体中的 DateTime 属性改为 DateTimeOffset
• DateTime.Now 改为 DateTimeOffset.Now
• 数据库列类型从 datetime2 改为 datetimeoffset

---

7.2.0

2026年7月28日 星期一

接口更新

• MyDbContextFactory<TDb> 泛型约束从 IDbConfiguration 更新为 IAppConfiguration
• IDbConfiguration 已删除，统一使用 IAppConfiguration

Demo 示例同步更新

• EntityConfigure → EntityHelper：种子数据中 16 处引用已更新
• IMyConfiguration → IAppConfiguration：TestDbContext 已更新
• .Dom → .Domain：TopicController 已更新
• IEnabled → IIsEnabled：StatusToggleTests 已更新

单元测试修复

• CreateTests：修正 3 个 CreateAsync 测试断言（ObjectResult + 201 状态码替代 CreatedAtActionResult）
• CreateTests：修正空 ID 测试，验证 GenerateId 返回空字符串时的行为

---

7.1.0

2026年7月28日 星期一

SQLite 数据库支持

• EntityHelper.UseDefaultTime() 新增 sql 参数，支持不同数据库的默认时间函数（SQLite: datetime('now')，PostgreSQL: NOW()，MySQL: CURRENT_TIMESTAMP）
• EntityHelper.UseStringKey() / UseStringBin() 新增 collation 参数，支持不同数据库的排序规则（SQLite: BINARY）
• 消费者只需在 DbContext.OnConfiguring() 中调用 UseSqlite(ConnectionString) 即可切换到 SQLite

新增类（向后兼容 — 旧类标记 [Obsolete]）

• EntityHelper：实体配置辅助类，替代 EntityConfigure（名称更清晰）
• WebApiIntBLL：基于 int 类型用户主键的 BLL，替代 WebApiForIntBLL
• WebApiLongBLL：基于 long 类型用户主键的 BLL，替代 WebApiForLongBLL

新增方法

• EntityHelper.UseUrl()：URL 路径配置方法（C# 命名规范：Url 而非 URL）

重命名（向后兼容）

• EntityConfigure → EntityHelper：旧类保留静态成员转发，扩展方法仅在新类中
• UseURL → UseUrl：旧方法标记 [Obsolete] 并转发到新方法
• WebApiForIntBLL → WebApiIntBLL：旧类保留并继承新类
• WebApiForLongBLL → WebApiLongBLL：旧类保留并继承新类

代码质量

• 修复 EntityHelper.cs region 注释拼写错误：Decimel → Decimal
• 重命名私有常量 parent_error_in_create → ParentErrorInCreate（PascalCase）
• 重命名私有字段 _dom → _domain（避免与 DOM 混淆）
• 重命名文件 BaseDAL.Kvps.cs → BaseDAL.Kvp.cs，WebApiBaseBLL.Kvps.cs → WebApiBaseBLL.Kvp.cs

---

7.0.0

2026年7月26日 星期日

重大版本：含多项破坏性变更，下游升级请阅读完整说明

破坏性变更（必须关注）

• DAL 层返回值由 HTTP code (int) 改为 ResultCode 枚举（200/201/204/400/403/404/409），解耦与 ASP.NET Core StatusCodes 的耦合；BaseDAL 公开方法签名变化
• BaseDAL 和 WebApiBaseBLL 拆分为 partial class（按职责分离到独立文件：Create / Delete / Detail / Kvps / List / Persistence / Statistics / Update），部分内部 API 可见性变化（IDE 的"转到定义"层级会变）

安全性与并发

• DAL 层捕获 DbUpdateConcurrencyException，写操作统一返回 Conflict(409)；先检查实体是否存在，不存在则返回 NotFound(404)
• 批量操作（obsolete 路径）启用事务保护（BeginTransactionAsync），updater 抛异常时回滚

性能

• DeleteListAsync / UpdateListAsync 改用 ExecuteUpdateAsync / ExecuteDeleteAsync 服务端执行，不再加载全部数据到内存
• Kvps 查询改用编译表达式，绕过 AsNoTracking 实体的 ChangeTracker
• MyDbContextFactory 读副本轮询改 Interlocked.Increment 无锁化（替代 Lock + ++index）
• IgnoreSpecialProperties 字典映射替代 10 个 if 检查

可靠性与一致性

• BaseDAL.Dispose 模式补全：_disposed 标志防重复释放；移除冗余 GC.SuppressFinalize
• WebApiBaseBLL 移除 Dispose，由 DI 容器统一管理 DAL 生命周期
• 缓存层：Create / Update / Delete 不再自动调用 InvalidateTotalCacheAsync()；下游若依赖 CRUD 后缓存自动失效，需改为显式调用（注意：此变更为不对称 Revert 的结果，详见 git log 92a976e ↔ 8fc943c）

API 与代码组织

• WebApiBaseBLL 同步方法标记 [Obsolete]，与 BaseDAL 对齐
• WebApiBaseBLL 提取 PrepareForCreate / ValidateUpdatePreCheck / ValidateUpdateCore / BuildSelfOnlyCondition，消除多处重复
• 级联查询支持 batch 模式（batchMode 参数，一次性加载全部）；引入 AsyncLocal 隔离 IsVerifyOwner / GetCurrentUserId；新增 NullableKeyWrapper 解决 nullable TKey 在 Dictionary 中的约束
• BaseDAL.SetWriteDb 恢复跟踪行为；Statistics 统一 AsNoTracking 并简化为表达式体
• Update 错误处理提取为私有方法；Kvps 简化
• IDomain 中未使用的 HTTP 类型依赖相关 refactor（commit 3eb4504）已被回退（65ae448），净状态未变
• DateTime.Now → DateTime.UtcNow 改造 + 注释死代码清理（commit ff13f66）已被回退（bf06cb9），净状态未变

项目结构

• SLN 嵌套重构：将 Crping.EFCore 项目从仓库根目录迁入 Crping.EFCore/ 子目录下（与 Common / Controller 一致），slnx 与 ProjectReference 路径相应更新

文档

• 所有类与方法补全 XML 文档注释
• 完整内部重构与注释微调（aa86f80 / 9c916de / 13d591c）

---

6.11.0

2026年6月16日 星期二

• 优化Create,Update,GetOrCreate相关方法
• 移除接口IDomainCommonMethods
• 移除BaseDomain中方法的virtual修饰符
• 升级所有相关组件版本

---

6.10.0

2026年6月9日 星期二

• 删除大部分方法的virtual修饰符
• 新增方法FirstOrDefaultAsync<TOrderKey, TResult> (IQueryOptions<TModel, TOrderKey, TResult>? options)，并添加相关接口方法
• 新增方法FirstOrDefault<TOrderKey, TResult> (IQueryOptions<TModel, TOrderKey, TResult>? options)，并添加相关接口方法

---

6.9.2

2026年3月20日 星期五

• 为Create相关方法添加字符串类型Id的检查与赋值逻辑，并添加异常明确的消息提示

---

6.9.1

2026年3月18日 星期三

• 优化创建相关方法的Id生成逻辑

---

6.9.0

2026年2月26日 星期三

• 扩展接口支持管理员权限：修改 IDetailsSelector、IEditorSelector、IGetDetails、IGetForEditor、IListItemSelector 等接口，添加管理员权限相关方法
• 增强 WebApiBaseBLL 类：添加 DetailsSelectorForAdmin、EditorSelectorForAdmin、ListItemSelectorForAdmin 等属性，支持管理员权限的数据选择

---

6.8.0

2026年2月6日 星期五

• 新增方法ToggleDeleteStatusAsync

---

6.7.0

2026年2月6日 星期五

• 优化软删除相关方法逻辑
• 新增状态切换方法ToggleEnableStatusAsync, ToggleAuditStatusAsync

---

6.6.0

2026年1月20日 星期二

• 新增属性Query
• 新增一系列求和、平均值方法
• 新增方法MaxPageSize并优化相关命名

---

6.5.0

2026年1月19日 星期一

• 新增工具类Toolkit

---

6.4.0

2025年12月31日 星期三

• 删除接口ICreateAndUpdateByDto
• 优化所有命名空间

---

6.3.0

2025年12月28日 星期日

• BLL添加并实现接口新增接口ICommonSelectors<TModel, TResult>, IListItemSelector<TModel, TResult>, IDetailsSelector<TModel, TResult>, IEditorSelector<TModel, TResult>, ISimpleSelector<TModel, TResult>,IGetKvps
• 优化方法GetKvpsAsync
• 新增接口ICreateAndUpdateByDto

---

6.2.0

2025年12月25日 星期四

• 新增接口ICommonSelectors<TModel, TResult>, IListItemSelector<TModel, TResult>, IDetailsSelector<TModel, TResult>, IEditorSelector<TModel, TResult>, ISimpleSelector<TModel, TResult>,IGetKvps
• 优化方法GetRawKvpsAsync, GetKvpsAsync

---

6.1.0

2025年12月2日 星期二

• 新增接口IDomainCommonMethods<TModel, TKey>, ICreateAsync<TModel>, IUpdateAsync<TModel, TKey>, IGetDetails<TKey>

---

6.0.0

2025年11月27日 星期四

• 升级为 .net10.0
• 适配ExecuteUpdate相关方法

---

5.11.0

2025年11月13日 星期四

• 新增接口：ICommonMethods<TKey>, IGetModelSelector

---

5.10.0

2025年11月2日 星期日

• 将所有列表方法的返回值从接口改为具体类型
• 新增Keyset分页方法GetKeysetListAsync，GetKeysetRawListAsync

---

5.9.0

2025年9月25日 星期四

• BaseDAL添加对IAudit，IDeletedAt的支持

---

5.8.0

2025年9月23日 星期二

• 优化BLL, DAL中所有更新相关方法对特殊状态属性的更新保留，并重命名部分方法

---

5.7.0

2025年7月31日 星期四

• BLL新增方法UpdateExcludeAsync
• DAL方法UpdateAsync新增更多特殊状态属性的更新保留

---

5.6.0

2025年7月31日 星期四

• 将Update相关方法的数组参数添加params

---

5.5.0

2025年6月18日 星期三

• GetByOptionsAsync 与GetBySelectorAsync 重命名为 GetByIdAsync

---

5.4.3

2025年5月23日 星期五

• 修复方法 SoftDeleteAsync(...)

---

5.4.2

2025年5月23日 星期五

• 修复方法 SoftDeleteAsync(...)

---

5.4.1

2025年5月23日 星期五

• WebApiBaseBLL 优化方法 SoftDeleteAsync(...)

---

5.4.0

2025年5月22日 星期四

• WebApiBaseBLL 新增方法SoftDeleteAsync, ResetSoftDeleteAsync

---

5.3.0

2025年5月21日 星期三

• 修改BaseDAL的方法 RangeLimit(...)

---

5.2.0

2025年4月19日 星期六

• WebApiBaseBLL 新增方法 GetByIdAsync，GetById

---

5.1.1

2025年4月9日 星期三

• 优化方法：CustomTimestamp(...)

---

5.1.0

2025年3月25日 星期二

• BaseDAL新增属性MaxList，新增方法SetMaxList(...)
• WebApiBaseBLL新增方法SetMaxList(...)
• 所有列表方法新增对列表最大数量的控制

---

5.0.2

2025年3月9日 星期日

• 统一子组件传递依赖中的组件版本

---

5.0.1

2025年3月9日 星期日

• 删除未使用的引用

---

5.0.0

2024年11月17日 星期日

• 升级为 .net9.0
• 更新引用组件，并清理替换弃用的组件

---

4.20.0

2024年11月16日 星期六

• AuthenticationHeaderValue 修改为 AuthHeaderValue
• GetAuthHeaderValue 修改为 GetAuthHeaderValue

---

4.19.0

2024年11月14日 星期四

• BaseDomain 新增委托 GetAuthenticationHeaderValue 以及属性 AuthenticationHeaderValue

---

4.18.0

2024年11月14日 星期四

• BaseDomain 新增委托 GetAuthorization 以及属性 Authorization

---

4.17.0

2024年11月12日 星期二

• 修改EntityConfigure中方法UseURL的默认值
• 新增方法SetTable

---

4.16.0

2024年10月22日 星期二

• EntityConfigure 添加方法 ToStringId(...) 并修改 GenerateId(...)
• DefaultDate 改为 DefaultTime

---

4.15.0

2024年10月20日 星期日

• 新增方法 GenerateId(...), CustomTimestamp(...)
• 修改方法 UseStringKey(...) 的参数顺序

---

4.14.0

2024年10月19日 星期六

• 新增实体配置辅助类 EntityConfigure 以及一系列常用方法

---

4.13.1

2024年10月16日 星期三

• BLL 方法 GetByOptionsAsync(...) 修改条件控制逻辑，优化使用外部传入控制条件

---

4.13.0

2024年10月12日 星期六

• BLL 新增接口 IConfigBLL
• BLL 修改类 BaseDomain 的构造方法参数与相关属性
• BaseDomain 新增方法 ShareDbContext

---

4.12.0

2024年10月11日 星期五

• BLL 新增接口 IGetSimple<TKey>

---

4.11.1

2024年10月11日 星期五

• BaseDomain 优化方法 SyncConfig()，并移除构造方法对 SyncConfig() 的调用

---

4.11.0

2024年10月11日 星期五

• BLL 修改 CurrentUserId 属性逻辑
• BaseDomain 修改 CurrentUserId 属性逻辑，以及构造函数，自动同步 BLL 配置
• 升级 EFCore 相关包引用

---

4.10.0

2024年10月6日 星期日

• 修复 BLL 中 IQueryOptions 的相关警告
• BLL 新增方法 GetBySelectorAsync(...)
• BLL 新增接口 IGetListItem
• 方法 GetForEditorAsync(...) 修改为 GetByOptionsAsync(...)

---

4.9.0

2024年9月25日 星期三

• BLL 新增接口 IGetDetails<TKey>，IGetForEditor<TKey>
• BLL 新增方法 GetForEditorAsync
• IQueryOptions 添加泛型约束

---

4.8.0

2024年9月20日 星期五

• 跳过有BUG的 4.7.0
• BLL新增方法SetCurrentUser
• BaseDomain修改构造方法，新增可选参数，并新增属性
• BaseDomain新增方法SyncConfig

---

4.6.0

2024年4月19日 星期五

• 将ILogger改为泛型
• BaseDomain新增对接口IKit的实现，增加对log，cache的支持

---

4.5.0

2024年4月9日 星期二

• 类WebApiBaseBLL新增可选构造参数IToolkit，以方便注入外部工具
• WebApiBaseBLL相关子类新增可选构造参数IToolkit，以方便注入外部工具
• 方法CheckStringId(...)修改逻辑，以调用IToolkit中的方法

---

4.4.0

2024年4月7日 星期日

• 清除不再使用的接口，如：IHostBLL等
• 添加新接口；IGenerateId
• 接口IDomain添加委托；GenerateId

---

4.3.0

2024年3月28日 星期四

• 新增接口：ICacheBLL
• 修改接口：IWebApiBLL，并新增IWebApiForIntBLL，IWebApiForLongBLL
• 修改WebApiBLL，并新增WebApiForIntBLL，WebApiForLongBLL
• 新增委托：GenerateId
• 所有创建相关方法添加字符串类型 Id 的检查与赋值

---

4.2.0

2024年3月15日 星期五

• 新增方法：Any(...)，AnyAsync(...)

---

4.1.0

2024年3月10日 星期日

• 新增方法：Forbidden(...)，MethodNotAllowed()

---

4.0.0

2024年1月27日 星期六

• 升级目标框架为.net8.0
• 升级EF相关组件为8.0以上最新版权
• 降级两个官方弃用的包
• 与系列相关组件对齐版本号

---

3.44.1

2023年11月13日 星期一

• SetDb(...)方法添加相同Db判断，跳过不必要的替换

---

3.44.0

2023-08-30

• 新增更简洁的获取键值对方法GetKvpsAsync

---

3.43.0

2023-07-27

• 为方法GetCacheValueAsync添加默认值

---

3.42.0

2023-07-24

• 修改IRelatedBLL
• 修改Update相关方法对UpdatedAt，UpdatedBy的赋值逻辑

---

3.41.0

2023-07-04

• 新增IDomain<TKey>，BaseDomain<TKey>

---

3.40.0

2023-06-29

• 为所有泛型参数TKey添加约束notnull
• 为用户操作自动绑定用户ID添加TUserKey，并添加notnull约束
• 修改所有接口类因添加TUserKey所引发的所有问题
• 修复所有创建功能因接口差异无法自动绑定创建者ID的问题
• 修复所有更新功能因接口差异无法自动绑定创建者ID的问题
• 修复所有删除功能因接口差异无法自动绑定创建者ID的问题

---

3.39.0

2023-06-11

• DAL新增方法GetKeysetRawListAsync(...)，及其接口
• BLL新增方法GetKeysetRawListAsync(...)，及其接口
• BLL新增方法GetKeysetListAsync(...)，及其接口
• WebApiResponse新增方法PaginationOk(...)
• 新增Keyset分页辅助类KeysetQueryOptions

---

3.38.0

2023-05-25

• 修改领域接口为IDomain，并新增委托GetCurrentUserId()
• 修改领域基类为BaseDomain，并新增委托GetCurrentUserId()

---

3.37.0

2023-05-18

• 新增领域接口IDomain<TUserKey>
• 新增领域基类BaseDomain<TUserKey>

---

3.36.1

2023-05-17

• 将方法FirstAsync(...)，First(...)的返回值改为非可空类型

---

3.36.0

2023-05-17

• DAL新增方法：FirstAsync(...)，First(...)
• BLL新增方法：FirstAsync(...)，First(...)
• BLL新增方法：TryCreateAsync(...)，TryCreate(...)

---

3.35.0

2023-05-17

• 新增方法TryCreateAsync(...)，TryCreate(...)

---

3.34.0

2023-05-12

• 新增种子数据接口ISeedData<T>

---

3.33.0

2023-05-11

• QueryOptions新增属性SelectFunc，并在所有列表相关方法中添加对其使用

---

3.32.0

2023-04-26

• 修复方法GetOrCreateAsync(...)系列方法内部查询库与创建库不一致的问题
• 新增方法：GetCascaderAsync(...)

---

3.31.0

2023-04-23

• QueryOptions新增查询标签属性Tag
• 为所有相关搜索列表方法添加对TagWith的调用

---

3.30.0

2023-04-04

• 启用可空类型
• 修复启用可空类型后产生的所有警告

---

3.22.0

2023-04-04

• DAL新增方法SetReadDbIfNull()，属性ReadIfNull
• DAL访问属性Db时，若为Null默认初始化为ReadDb
• BLL将默认调用的方法WriteIfNull改为ReadIfNull

---

3.21.0

2023-03-28

• 将接口IConnectionString，IMyConfiguration转移到Common

---

3.20.1

2023-03-13

• 将GetKvpsAsync的零值项目名称请选择改为全部

---

3.20.0

2023-02-24

• DAL新增LongCountAsync，LongCount
• BLL新增LongCountAsync，LongCount
• BLL修改TotalAsync相关方法，新增最后几天限定统计

---

3.19.0

2023-02-17

• DAL新增方法SetNoTracking，SetTrackAll
• DAL将_db等重要对象私有化
• DAL将所有对私有字段的访问改为公共属性，并去除所有多余的判空逻辑
• DAL在切换为只读库里自动关闭查询跟踪
• BLL新增属性Dal，用于统一验证
• BLL将所有对_dal字段的引用改为属性Dal
• BLL并去除所有多余的判空逻辑
• BLL新增几个未添加的接口
• BLL新增接口IKit，属性Cache，Logger

---

3.18.0

2023-02-03

• 将运行时修改为net7.0

---

3.17.1

2023-01-13

• BLL修改方法Task<IActionResult> TotalAsync()中的默认缓存Key

---

3.17.0

2023-01-13

• BLL新增方法Task<int> TotalAsync(string, TimeSpan?, TimeSpan?)
• BLL新增方法Task<IActionResult> TotalAsync()

---

3.16.0

2023-01-09

• DAL新增方法(int, TModel) CreateModel(TModel model)
• BLL新增方法(int, TModel) CreateModel(TModel model)
• BLL将3.15版所有新增方法的返回值改为(int, TModel)

---

3.15.0

2023-01-09

• DAL新增同步方法FirstOrDefault(condition)
• BLL新增方法GetOrCreate(model)，GetOrCreateAsync(model)
• BLL新增方法GetOrCreate(model, condition)，GetOrCreateAsync(model, condition)

---

3.14.0

2023-01-03

• 更新对Crping.EFCore.Common的引用，EFCore相关组件的升级
• 新增全局引用Global，并优化所有引用、命名空间、以及部分注释

---

3.13.0

2022-12-15

• 新增接口IMyConfiguration，用于向DbContext相关类传递配置对象
• MyDbContextFactory<TDb>类添加IConfiguration属性，并通过方法CreateDbContext将此属性赋值给DbContext相关类

---

3.12.0

2022-12-09

• 添加批量删除方法ExecuteDelete，ExecuteDeleteAsync

---

3.11.0

2022-12-09

• 添加批量更新方法ExecuteUpdateAsync，ExecuteUpdate

---

3.10.1

2022-11-28

• 解决'pagination'添加返回值'orderBy'在不同.net版本中的返回值不同的问题

---

3.10.0

2022-11-28

• DAL的列表分页返回类型'pagination'添加返回值'orderBy'

---

3.9.1

2022-11-26

• 解决pagination添加返回值Ascending时queryOptions为空的Bug

---

3.9.0

2022-11-23

• pagination添加返回值Ascending
• 升级EFCore到7.0.0

---

3.8.0

2022-09-17

• GetValueFromCacheAsync重命令为GetCacheValueAsync，并删除参数isRefresh
• 新增重载方法Task<int> GetCacheValueAsync(string key, Func<Task<int>> getNewValue, TimeSpan? slidingExpiration, TimeSpan? absoluteExpirationRelativeToNow)

---

3.7.1

2022-09-16

• GetPageCountFromCacheAsync 重命名为 GetValueFromCacheAsync
• 修改GetValueFromCacheAsync的委托参数的返回类型，以支持异步方法

---

3.7.0

2022-09-16

• 添加内部工具类Utils
• 添加分页缓存方法：GetPageCountFromCacheAsync

---

3.6.0

2022-06-05

• 将所有DAL中业务相关逻辑转移到BLL，并将部分强制更新字段改为可选更新

---

2022-05-18

• 修改所有InitDb相关方法
• BLL层添加SetReadDb，SetWriteDb方法

---

2022-04-01

1. 更新对Crping.EFCore.Common的引用，并对齐版本号

---

2021-07-15：

1. IWebApiBLL接口与基础实现类添加Read，Write属性，以实现读写分离链接调用
2. IBaseDAL接口与与基础实现类添加Read，Write属性，以实现读写分离链接调用
3. IBaseDAL接口与与基础实现类添加ReadOnly方法，以实现以参数的方式读写分离链接调用
4. IWebApiBLL接口与基础实现类去除所有readOnly参数，改为链式调用

---

历史记录

• 3.6.0：将所有DAL中业务相关逻辑转移到BLL，并将部分强制更新字段改为可选更新
• 3.5.1：更新引用组件版本
• 3.5.0：修改所有InitDb相关方法，BLL层添加SetReadDb，SetWriteDb方法
• 3.4.0：添加IHostBLL，删除IRelatedBLL，并修改相关方法
• 3.3.0：更新对Crping.EFCore.Common的引用，并对齐版本号
• 3.1.0：给所有方法添加判空逻辑，DbContextFactory类改为MyDbContextFactory
• 3.0.0：目标框架改为.net6.0，并引用EFCore6.0
• 2.4.0：新增方法：ShareCurrentUserIdFunc，重命名方法：ShareDbContext
• 2.3.0：新增方法 GetRawKvpsAsync，并升级EFCore到5.0.10
• 2.2.0：添加带条件的 Include 扩展方法
• 2.1.0：修改默认排序BUG，新增IDisposable, IAsyncDisposable
• 2.0.2：获取列表相关方法添加默认以ID为排序方式的升降序配置
• 2.0.1：CreateDbContext ReadOnly时添加Lock，以防多线程处理时数组越界
• 2.0.0：使用自定义DbContextFactory，延迟创建DbContext等（重大改版！！！）
• 1.5.3：GetKvpsAsync添加参数，修改默认排序
• 1.5.2：修复共享DbContext时的Bug
• 1.5.1：添加DbContext共享
• 1.5.0：重要!!，添加并实现IRelatedBLL接口，拆分DAL，BLL为CRUD等接口
• 1.4.1：去除GetCurrentUserID未赋值时的默认值0，暴露BUG
• 1.4.0：增加并修改DAL、BLL层相关列表方法
• 1.3.1：简化Get类方法重载的参数
• 1.3.0：BLL中的列表方法添加一系列重载
• 1.2.0：修改DAL，BLL的实现基类名称
• 1.1.0：添加Read、Write属性以链式调用方式取代传参方式。
• 1.0.0：包含数据库常规操作的DAL基类，WebApi常规操作的BLL基类等