Crping.EFCore.Common 7.4.0

Crping.EFCore.Common

Crping.EFCore的接口与类型定义

版本更新说明

---

7.3.0

2026年7月30日 星期三

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

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

• IModel<TKey>.CreatedAt：DateTime → DateTimeOffset
• IUpdatedAt.UpdatedAt：DateTime? → DateTimeOffset?
• IDeletedAt.DeletedAt：DateTime? → DateTimeOffset?
• IDelete<T>.DeletedAt：DateTime? → DateTimeOffset?
• IAuditor<T,U>.AuditedAt：DateTime? → DateTimeOffset?
• ICreatedDate.CreatedDate：DateTime → DateTimeOffset
• ICreatedTime.CreatedTime：DateTime → DateTimeOffset
• IStartTime.StartTime：DateTime? → DateTimeOffset?
• IStartDate.StartDate：DateTime? → DateTimeOffset?
• IEndDate.EndDate：DateTime? → DateTimeOffset?
• IEndTime.EndTime：DateTime? → DateTimeOffset?

其他变更

• IParent<T>：支持可空类型参数（如 IParent<int?>），根节点可使用 null

迁移指南

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

---

7.2.0

2026年7月28日 星期一

与 Crping.EFCore / Crping.EFCore.Controller 同步升至 7.2.0

新增接口

• IAppConfiguration：应用配置引用接口，提供 IConfiguration 实例，语义比 IDbConfiguration 更准确

重命名（向后兼容）

• IMyConfiguration → IAppConfiguration：旧接口标记 [Obsolete] 并继承新接口
• IDbConfiguration：已删除（上一版本新增，因命名不当移除）

---

7.1.0

2026年7月28日 星期一

与 Crping.EFCore / Crping.EFCore.Controller 同步升至 7.1.0

新增接口

• IViewObject：视图对象输出接口，替代 IToVo
• IDbConfiguration：数据库配置接口，替代 IMyConfiguration

重命名（向后兼容 — 旧接口标记 [Obsolete]）

• IToVo → IViewObject：旧接口保留并继承新接口，编译时产生 CS0618 警告
• IMyConfiguration → IDbConfiguration：旧接口保留并继承新接口
• IEnabled → IIsEnabled：旧接口标记 [Obsolete]（属性名 Enabled vs IsEnabled 不同，无法继承）
• IDisabled → IIsDisabled：旧接口标记 [Obsolete]

---

7.0.0

2026年7月26日 星期日

与 Crping.EFCore / Crping.EFCore.Controller 同步升至 7.0.0

• 修复：ModelWithName.Name setter 增加 null 防护 — 之前 value.Trim() 在 value 为 null 时会抛 NullReferenceException，现改为 value?.Trim() ?? string.Empty
• 清理：删除 3 个全注释死代码文件（破坏性变更 — 下游若手动引用这些类型会编译失败）
  • Models/GenericConverter.cs
  • Models/UserKey.cs
  • Enums/TaskState.cs
• 内部：DateTime.Now → DateTime.UtcNow 改造（ModelBase.CreatedAt / EFCoreExt.UpdateTo）曾被提交后又完整回退，净状态未变

---

6.4.0

2026年7月16日 星期四

• 优化所有命名空间
• 调整项目目录结构：Crping.EFCore.* 项目统一嵌套到 Crping.EFCore/ 下

---

6.0.0

2025年11月27日 星期四

• 升级为 .net10.0

---

5.5.0

2025年10月21日 星期二

• 新增扩展方法NotDisabled(...), NotIsDisabled(...), OnlyEnabled(...), OnlyIsEnabled(...)

---

5.4.0

2025年9月25日 星期四

• 新增接口IDeletedAt, IAuditor, IAudit

---

5.3.0

2025年7月8日 星期二

• 新增过滤软删除扩展方法NotSoftDeleted

---

5.2.1

2025年6月29日 星期日

• 新增接口IAddress<T>

---

5.2.0

2025年5月22日 星期四

• 新增接口ISoftDelete

---

5.1.0

2025年4月19日 星期六

• 新增接口：IContents<T>，ITitle<T>

---

5.0.0

2024年11月17日 星期日

• 升级为 .net9.0
• 更新引用组件

---

4.5.0

2024年10月19日 星期六

• 接口 IKey<TId>，IModel<TKey> 默认类型改为 string

---

4.3.0

2024年4月12日 星期五

• 新增接口ISortIndex<T>，IIsEnabled

---

4.2.0

2024年4月9日 星期二

• 新增接口IToolkit

---

4.1.0

2024年3月28日 星期四

• 修改：Cascader<TKey>为Cascade<TKey>
• 新增接口：IAccount，IAvatar，IEmail，IIsDisabled，IPhoneNumber

---

4.0.1

2024年3月21日 星期四

• 移除ICreate中TKey的notnull约束

---

4.0.0

2024年1月27日 星期六

• 升级目标框架为.net8.0
• 升级Microsoft.Extensions.Configuration.Abstractions为8.0
• 与系列相关组件对齐版本号

---

3.20.1

2023-08-22

• 接口ICreatedDate，ICreatedTime的日期改为不为空

---

3.20.0

2023-07-24

• 新增接口IUpdatedAt
• 修改接口IUpdate<TUserKey>

---

3.19.0

2023-06-29

• 为所有泛型参数TKey添加约束notnull
• 重命名部分泛型参数
• 新增接口IUpdate<TKey>，IDelete<TKey

---

3.18.0

2023-06-11

• 新增接口IKeysetPagination，以及实现类KeysetPagination
• 新增扩展方法GetValue(...)

---

3.17.0

2023-06-07

• 新增升序扩展方法Ascending(...)
• 新增降序扩展方法Descending(...)

---

3.16.0

2023-05-21

• 新增接口ICreator<TUser, TKey>

---

3.15.0

2023-05-11

• 新增接口IToVo

---

3.14.0

2023-05-10

• IIntro修改为可空
• 修改日期时间相关接口的数据类型为DateTime?
• 新增接口INickname
• 修改接口IUserName为IUsername

---

3.13.0

2023-05-10

• 新增接口：IUpdater<T>，IDeleter<T>，IAddress

---

3.12.0

2023-04-26

• 新增接口：IParent<T>
• 新增实体：Cascader<TKey>

---

3.11.0

2023-04-20

• 新增接口ICreate<T>

---

3.10.0

2023-04-15

• 项目启用可空类型
• 修复启用可空类型后产生警告的代码
• 新增接口ICreator
• 修改接口IConnectionString，IMyConfiguration

---

3.8.0

2023-03-28

• 从Crping.EFCore移入接口IConnectionString,IMyConfiguration

---

3.7.0

2023-02-18

• 新增接口IKeysetPagination与类KeysetPagination

---

3.6.0

2023-02-03

• 将运行时修改为net7.0

---

3.5.1

2023-01-03

• 新增接口：IKey:IKey<int>

---

3.5.0

2023-01-03

• 新增接口IKey<>，并添加到IModel<>
• 新增全局引用Global，并优化所有代码

---

3.4.0

2022-05-18

• 修改 IPagination 和 Pagination 的排序方式字段

---

历史版本

• 3.4.0：修改 IPagination 和 Pagination 的排序方式字段
• 3.3.0：添加IGender，IIntro等一系列常用接口
• 3.2.1：重命名接口ICreatedDate,ICreatedTime，并修改其属性类型
• 3.2.0：添加枚举ProcessingStatus，接口IProcessingStatus
• 3.1.4：优化JsonPropertyOrder值
• 3.1.3：为属性添加JsonPropertyOrder
• 3.1.2：为Name属性添加字段长度限制
• 3.1.1：为属性添加[Column(Order = 0)]等
• 3.1.0：添加ModelBase，IName，ModelWithName等
• 3.0.2：Utils类改为EFCoreEx
• 3.0.1：修改PaginationData，以适应Dapr反序列化
• 3.0.0：目标框架改为.net6.0
• 1.1.3：还原Pagination的部分修改
• 1.1.2：修复Pagination的Bug
• 1.1.1：优化Pagination的CountPages()方法
• 1.1.0：Pagination 添加 QueryString 属性
• 1.0.0：提供 Crping.EFCore 组件所需基础类接口等

2022-04-01

1. 重命名接口ICreatedDate,ICreatedTime，并修改其属性类型
2. 添加一系列常用接口

2022-03-14

1. 添加枚举：ProcessingStatus
2. 添加接口：IProcessingStatus

2022-02-28

1. 添加ModelBase<T>，ModelBase
2. 添加IName, ModelWithName<T>，ModelWithName
3. 为属性添加[Column(Order = 0)]等
4. 为Name属性添加字段长度限制
5. 为属性添加：JsonPropertyOrder
6. 优化Column(Order = 0)，JsonPropertyOrder