Dapper如何传递参数 Dapper参数化查询方法_石家庄创泽智能科技有限公司

新闻中心 NEWS CENTER

2025-12-14

浏览次数：次

Dapper仅支持命名参数（如@name），不支持位置占位符；常用匿名对象、强类型类或Dictionary传参，均需键名与SQL中@后名称严格一致；列表参数可直接用于IN查询，但空列表需特殊处理。

dapper如何传递参数 dapper参数化查询方法

Dapper 传递参数主要靠匿名对象、强类型对象或字典，核心是让 SQL 中的参数名（如 @name、@id）能与传入值自动匹配。它不支持位置占位符（如 ?），只认命名参数，这是关键前提。

适合简单查询，代码简洁直观：

SQL 字符串中写 @参数名，例如 "SELECT * FROM Users WHERE Age > @minAge AND Status = @status"
调用时传入 new { minAge = 18, status = "Active" }，属性名必须和 SQL 中的 @ 名完全一致（区分大小写）
值为 null 会被正确映射为数据库 NULL，无需额外处理

适合多处复用、逻辑清晰、IDE 有提示的场景：

定义一个类（如 UserQuery），含 public int MinAge { get; set; } 和 public string Status { get; set; }
new 出实例后直接传入：dapper.Query(sql, new UserQuery { MinAge = 18, Status = "Active" })
Dapper 会通过反射读取 public 属性，忽略字段、私有成员和方法

适合参数名不确定、运行时生成条件的场景：

美图AI开放平台

美图推出的AI人脸图像处理平台

111 查看详情美图AI开放平台

构建字典：var param = new Dictionary<string object>(); param["minAge"] = 18; param["status"] = "Active";</string>
注意 key 是字符串，且要和 SQL 中的 @key 完全一致；value 支持任意类型（包括 null、列表等）
比匿名对象更灵活，但失去编译期检查，容易拼错键名

Dapper 原生支持数组/列表作为参数，自动展开为逗号分隔的参数序列：

SQL 写成："SELECT * FROM Users WHERE Id IN @ids"（注意是 @ids，不是 @ids[0]）
传参：new { ids = new[] { 1, 2, 3 } }，Dapper 会自动转为 IN (@ids1, @ids2, @ids3) 并绑定
列表为空时，Dapper 会抛异常（因为 IN () 语法非法），需提前判断并改写 SQL 或返回空结果