FreeSql 弱类型 CRUD 操作中 Update 方法 IgnoreColumns 使用注意事项

在使用 FreeSql 进行弱类型 CRUD 操作时，开发者可能会遇到 IgnoreColumns 方法在 Update 操作中不起作用的情况。本文将从技术原理和实际应用角度，深入分析这个问题并提供解决方案。

问题现象

当开发者使用弱类型方式执行 Update 操作时，可能会尝试以下代码：

var res = await DB.SqlServer.Update<object>()
    .AsType(Type.GetType($"Models." + TableName))
    .SetDto(ndata)
    .WhereDynamic(type.GetProperty("Id").GetValue(ndata))
    .IgnoreColumns(new[] { "Id" })
    .ExecuteUpdatedAsync();

预期是忽略 Id 列的更新，但实际执行时发现 IgnoreColumns 并未生效。

原因分析

FreeSql 提供了两种不同的更新模式，它们对 IgnoreColumns 的处理方式不同：

1. SetSource + IgnoreColumns/UpdateColumns 组合模式

   • 这是 FreeSql 推荐的更新方式
   • 在这种模式下，IgnoreColumns 会按预期工作

2. SetDto 模式

   • SetDto 实际上是批量 Set 操作的快捷方式
   • 在这种模式下，IgnoreColumns 不会生效

解决方案

要正确使用 IgnoreColumns 功能，应该采用 SetSource 方式：

var res = await DB.SqlServer.Update<object>()
    .AsType(Type.GetType($"Models." + TableName))
    .SetSource(ndata)
    .IgnoreColumns(new[] { "Id" })
    .WhereDynamic(type.GetProperty("Id").GetValue(ndata))
    .ExecuteUpdatedAsync();

最佳实践

1. 明确更新模式选择

   • 如果需要精细控制更新的列，使用 SetSource + IgnoreColumns/UpdateColumns
   • 如果需要简单快捷地更新所有列，使用 SetDto

2. 弱类型操作注意事项

   • 使用 AsType 指定实体类型
   • 确保动态获取的属性名与数据库列名一致
   • 考虑使用 DTO 而非直接操作动态类型

3. 性能考虑

   • SetSource 方式可以精确控制更新的列，减少不必要的数据库操作
   • 对于大批量更新，SetDto 可能更高效

总结

FreeSql 提供了灵活的 CRUD 操作方式，但不同方法有不同的适用场景和行为特点。理解 SetSource 和 SetDto 的区别，可以帮助开发者更高效地使用 FreeSql 进行数据操作。在需要忽略特定列更新的场景下，务必使用 SetSource 而非 SetDto 方式。