17370845950

Dapper 查询数据的核心是 Query 方法家族，直接执行 SQL 并映射为对象；支持多行（Query）、单行（QueryFirstOrDefault 等）、动态/匿名查询，以及缓冲控制和 IN 参数等进阶技巧。

Dapper 查询数据的核心就是 Query 方法家族，它不搞抽象封装，直接让你写 SQL，再把结果映射成对象。用法简单，但细节决定是否健壮、安全、高效。

基础查询：Query 返回多行

这是最常用的查询方式，适合查列表、分页、批量数据。

• 必须指定泛型类型 T（如 User、Product），Dapper 会按属性名自动匹配列名（大小写不敏感）
• SQL 中用 @参数名 占位，传参用匿名对象或实体对象，天然防 SQL 注入
• 返回 IEnumerable，支持延迟执行；调用 .ToList() 才真正取数

示例：

string sql = "SELECT Id, Name, Email FROM Users WHERE Age > @Age AND Status = @Status";
var users = connection.Query(sql, new { Age = 18, Status = "Active" }).ToList();

单行查询：选对方法很关键

不同场景要选不同方法，它们对“无结果”或“多结果”的处理逻辑完全不同：

• QueryFirstOrDefault()：有就返回第一条，没有就返回 default(T)（null 或 0）——最常用
• QueryFirst()：必须至少有一行，否则抛异常
• QuerySingle()：必须且仅有一行，否则抛异常（适合主键精确查询）
• QuerySingleOrDefault()：最多一行，有就返回，没就 null，多于一行则抛异常

示例：

var user = connection.QueryFirstOrDefault("SELECT * FROM Users WHERE Id = @Id", new { Id = 123 });

动态与匿名查询：不用定义类也能查

临时查、调试、导出、字段不确定时，可用 dynamic 或匿名类型：

• 不带泛型的 Query() 返回 IEnumerable，每行是 ExpandoObject，可按列名访问：row.Name、row.Email
• 也可用 new { } 匿名对象接收单行：var result = connection.Query("SELECT COUNT(*) c FROM Users").FirstOrDefault(); → 得到 dynamic 对象，再取 result.c

示例（查统计）：

var countObj = connection.Query("SELECT COUNT(*) AS Total FROM Orders").FirstOrDefault();
int total = countObj?.Total ?? 0;

进阶技巧：缓冲控制与 IN 查询

大数据量或特殊场景下，几个实用细节：

• 加 buffered: false 可启用非缓冲查询，适合逐行流式处理（避免内存爆满）：connection.Query(sql, buffered: false)
• IN 条件直接传数组，Dapper 自动展开：WHERE Id IN @ids + new { ids = new[] { 1, 2, 3 } }
• 空值参数也支持：WHERE (@Name IS NULL OR Name LIKE @Name)，传 new { Name = (string)null } 即可

示例（IN 查询）：

string sql = "SELECT * FROM Products WHERE CategoryId IN @categoryIds";
var products = connection.Query(sql, new { categoryIds = new[] { 1, 5, 8 } }).ToList();

基本上就这些。Dapper 的 Query 不复杂，但容易忽略参数安全、空值处理和缓冲策略这些细节。写 SQL 时保持简洁，映射时注意命名一致，再配合适当的方法选择，就能稳稳查出你要的数据。