EntityFramework-Plus 中 BulkInsertAsync 方法 ForceValueGeneratedStrategy 选项变更解析

背景介绍

EntityFramework-Plus 是一个流行的 .NET ORM 扩展库，它为 Entity Framework Core 提供了批量操作、审计追踪、查询缓存等增强功能。在最新版本更新中，BulkInsertAsync 方法的一个重要选项发生了变更，这可能会影响现有代码的正常运行。

变更内容

在 EntityFramework-Plus 8.103.0 版本中，移除了 ForceValueGeneratedStrategy 选项及其相关的 ValueGeneratedStrategyType 枚举类型。这个变更影响了使用以下代码模式的开发者：

await _dbSet.BulkInsertAsync(entities, options => { 
    options.ForceValueGeneratedStrategy = ValueGeneratedStrategyType.OnAddOrUpdate; 
});

替代方案

新版本中引入了 ExplicitValueResolutionMode 枚举来替代原有的功能。具体对应关系如下：

原代码：

options.ForceValueGeneratedStrategy = ValueGeneratedStrategyType.OnAddOrUpdate;

应替换为：

options.ExplicitValueResolutionMode = ExplicitValueResolutionMode.AlwaysKeepValueOnInsertOrUpdate;

深入理解变更原因

这一变更反映了 EntityFramework-Plus 对值生成策略的更精细化控制。新的 ExplicitValueResolutionMode 提供了更明确的语义，能够更清晰地表达开发者在批量插入操作中对值处理方式的意图。

影响范围

这一变更主要影响以下场景：

1. 在批量插入操作中需要控制值生成行为的代码
2. 依赖 ValueGeneratedStrategyType.OnAddOrUpdate 行为的现有实现
3. 跨版本升级的项目

迁移建议

对于正在升级项目的开发者，建议：

1. 全局搜索项目中所有使用 ForceValueGeneratedStrategy 的地方
2. 按照上述对应关系进行替换
3. 测试替换后的代码，确保业务逻辑不受影响

总结

EntityFramework-Plus 8.103.0 版本的这一变更是为了提供更清晰、更强大的值处理控制能力。虽然这带来了短暂的迁移成本，但从长远来看，新的 API 设计更加合理，能够更好地满足复杂场景下的需求。开发者在升级时应注意这一变更，及时调整相关代码。