SmartDapper 1.1.1

SmartDapper

SmartDapper 是一个基于 Dapper 的轻量级扩展库，提供 表达式树转 SQL、通用 CRUD、分页查询 与 多数据库适配（SQL Server / MySQL / SQLite）。默认参数化执行，以降低 SQL 注入风险。

安装

dotnet add package SmartDapper

快速开始（SQL 生成 + Dapper 执行）

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
using Dapper;
using Microsoft.Data.SqlClient;
using SmartDapper.SqlGenerator;

[Table("Users")]
public class User
{
    [Key]
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public int Id { get; set; }

    public string UserName { get; set; } = string.Empty;
    public bool IsActive { get; set; }
}

var generator = SqlGeneratorFactory.CreateSqlServer<User>();
var (sql, parameters) = generator.GetSelectAll(u => u.IsActive);

using var conn = new SqlConnection("Server=.;Database=MyDb;Trusted_Connection=True;TrustServerCertificate=True;");
var users = conn.Query<User>(sql, parameters).ToList();

使用扩展方法（IDbConnection）

using Microsoft.Data.SqlClient;
using SmartDapper.Extensions;

using var conn = new SqlConnection("Server=.;Database=MyDb;Trusted_Connection=True;TrustServerCertificate=True;");

var list = await conn.GetAllListAsync<User>(u => u.IsActive);
var (items, total) = await conn.GetPagedListAsync<User>(skip: 0, take: 20);

表达式树支持范围（WHERE / IN / LIKE / UPDATE SET）

SmartDapper 的“表达式树转 SQL”主要用于 Expression<Func<T, bool>>（WHERE 谓词），以及更新场景的 Expression<Func<T, object>>（SET 字段选择/赋值）。

WHERE（Expression<Func<T, bool>>）支持项

UPDATE 的 SET（Expression<Func<T, object>>）支持写法

适用于：conn.UpdateSet<T>().Set(...) / conn.Update(updateFields, predicate) 等。

典型不支持/慎用

安全限制（重要）

• UPDATE/DELETE 禁止恒真条件：例如 x => true、或 All(empty) 导致的 1 = 1，会被拦截（防止误全表操作）。
• Fluent 查询限制：
  • Paging(skip, take) 不能与自定义 OrderBy(...) 组合使用（分页 SQL 已内置排序规则）。
  • 投影查询（Select(projection)）不支持 Paging(...)，也不支持与 SelectColumns(...) 混用。

链式扩展（Fluent Builder）

SmartDapper 提供了一组面向 IDbConnection 的链式构建器，用于以“命令式链式 API”组织查询/插入/更新/删除，并在内部复用 SmartDapper 的 SQL 生成能力。

命名约定：QuerySet<T>() / InsertSet<T>() / UpdateSet<T>() / DeleteSet<T>()。构建器对象非线程安全，建议按一次请求/一次操作创建并使用一次。

查询（Select）

using SmartDapper.Extensions;

// 1) 全字段查询 + Where + OrderBy
var list = await conn.QuerySet<User>()
    .Where(u => u.IsActive && u.Age >= 18)
    .OrderBy(u => u.Id, ascending: true)
    .ToListAsync();

// 2) 指定列（两种方式：表达式/字符串）
var columns = await conn.QuerySet<User>()
    .SelectColumns(u => new { u.Id, u.UserName })
    .ToListAsync();

var columns2 = await conn.QuerySet<User>()
    .Select("Id", "UserName")
    .ToListAsync();

// 3) 投影（DTO/匿名类型）
var dtoList = await conn.QuerySet<User>()
    .Select(u => new { u.Id, u.UserName })
    .Where(u => u.IsActive)
    .OrderBy(u => u.Id)
    .ToListAsync();

删除（Delete）

// 1) 条件删除
var affected = await conn.DeleteSet<User>()
    .Where(u => u.IsActive == false)
    .ExecuteAsync();

// 2) 按主键删除
var affected2 = await conn.DeleteSet<User>()
    .ByKey(1)
    .ExecuteAsync();

插入（Insert）

// 1) 自动创建实体并填充
var newId = await conn.InsertSet<User>()
    .Fill(u => { u.UserName = "Alice"; u.IsActive = true; })
    .ExecuteAndGetIdAsync();

// 2) 基于已有实体实例
var user = new User { UserName = "Bob", IsActive = true };
await conn.InsertSet(user).ExecuteAsync();

更新（Update）

// 1) 推荐：对象初始化器（表达式树提取值）
var rows = await conn.UpdateSet<User>()
    .Set(u => new User { UserName = "Alice", IsActive = true })
    .Where(u => u.Id == 1)
    .ExecuteAsync();

// 2) 也支持：匿名对象（字段名按“属性名/列名”处理）
var rows2 = await conn.UpdateSet<User>()
    .Set(new { UserName = "Alice", IsActive = true })
    .Where(u => u.Id == 1)
    .ExecuteAsync();

Fluent 的已知限制/注意事项

• 分页与排序：QuerySet<T>().Paging(skip, take) 目前不支持与自定义 OrderBy(...) 同用（分页 SQL 已内置排序规则）。
• 投影限制：投影链（Select(projection)）目前不支持 Paging(...)，也不支持与 SelectColumns(...) 混用。
• First/Single：FirstOrDefault()/SingleOrDefault() 不会强制加 TOP/LIMIT，仅对结果集做“取第一条/单条”的行为（多条命中时 SingleOrDefault 会抛异常）。

多数据库支持

• SQL Server：SqlGeneratorFactory.CreateSqlServer<T>()
• MySQL：SqlGeneratorFactory.CreateMySql<T>()
• SQLite：SqlGeneratorFactory.CreateSqlite<T>()

相关包

• SmartDapper.Repository：Repository + UnitOfWork
• SmartDapper.Middleware：ASP.NET Core 中间件 + 声明式事务（[UnitOfWork]）