Dapper怎么处理带@符号的参数名 Dapper参数命名规范

Dapper 使用 @参数名 作为参数占位符，SQL 中必须带 @ 前缀（如 @Id），C# 传参对象属性名不带 @（如 Id），大小写需一致；支持数组 IN 查询自动展开；复杂场景推荐 DynamicParameters。

Dapper 使用 @参数名 作为标准的参数占位符，这是它参数化查询的核心机制。@ 符号本身不是 SQL 语法的一部分，而是 Dapper 约定的命名前缀，用于将 C# 对象属性或匿名对象字段映射到 SQL 中的参数位置。

参数命名必须带 @ 前缀（SQL 语句中）

在写 SQL 字符串时，所有参数都必须显式以 @ 开头，比如：

• SELECT * FROM Users WHERE Id = @Id AND Status = @Status
• INSERT INTO Logs (Msg, Time) VALUES (@Msg, @Time)

Dapper 会自动提取 @ 后面的名称（如 Id、Status），然后去传入的参数对象中查找同名属性或字段。不加 @，Dapper 就无法识别为参数，直接当作字面量处理，容易引发 SQL 注入或运行时报错。

传参对象里的属性名不加 @

你在 C# 里构造参数时，属性名不能带 @，否则匹配失败：

• ✅ 正确：new { Id = 123, Status = "Active" }
• ❌ 错误：new { @Id = 123, @Status = "Active" }（C# 语法错误）
• ❌ 无效：new { Id = 123, Status = "Active", "@Id" = 123 }（字符串键名无法被 Dapper 自动映射）

也就是说：SQL 里写 @Id，C# 里用 Id；大小写需完全一致（默认区分大小写）。

支持 DynamicParameters 动态添加带 @ 的参数

当需要更精细控制（比如输出参数、指定 DbType 或方向），推荐用 DynamicParameters：

• parameters.Add("@UserId", 1001, DbType.Int32);
• parameters.Add("@Result", dbType: DbType.Int32, direction: ParameterDirection.Output);

注意：这里 Add 方法的第一个参数是完整参数名（含 @），Dapper 会原样传递给底层 ADO.NET。这也是解决“必须声明标量变量 @xxx”错误的正确方式——别用原生 SqlParameter，改用 DynamicParameters。

IN 查询和数组参数的特殊处理

Dapper 支持简洁的数组参数语法，无需手动展开：

• SQL 中写：WHERE Id IN @Ids
• C# 中传：new { Ids = new[] { 1, 2, 3 } }

Dapper 会自动把数组转成 @Ids0, @Ids1, @Ids2 并绑定值，整个过程仍遵循 @ 命名规则，只是隐藏了拼接细节。

基本上就这些。记住关键点：SQL 里带 @，C# 里不带 @，大小写敏感，复杂场景用 DynamicParameters —— 不复杂但容易忽略。

# app  # c#  # .net  # sql  # select  # 字符串  # 输出参数  # 对象  # 不带  # 不加  # 这是  # 第一个  # 你在  # 能带  # 转成  # 里用  # 象中  # 也就是说 

相关文章： 网站制作难吗安全吗,做一个网站需要多久时间？  免费视频制作网站,更新又快又好的免费电影网站？  黑客入侵网站服务器的常见手法有哪些？  如何快速上传建站程序避免常见错误？  网站制作外包价格怎么算,招聘网站上写的“外包”是什么意思？  如何设置并定期更换建站之星安全管理员密码？  兔展官网 在线制作,怎样制作微信请帖？  制作旅游网站html,怎样注册旅游网站？  建站主机系统SEO优化与智能配置核心关键词操作指南  Android自定义控件实现温度旋转按钮效果  外贸公司网站制作,外贸网站建设一般有哪些步骤？  如何通过可视化优化提升建站效果？  如何在Windows服务器上快速搭建网站？  网站制作企业,网站的banner和导航栏是指什么？  品牌网站制作公司有哪些,买正品品牌一般去哪个网站买？  如何通过服务器快速搭建网站？完整步骤解析  代刷网站制作软件,别人代刷火车票靠谱吗？  制作网站的软件下载免费,今日头条开宝箱老是需要下载怎么回事？  招商网站制作流程,网站招商广告语？  建站主机选哪家性价比最高？  制作门户网站的参考文献在哪,小说网站怎么建立？  网站制作的方法有哪些,如何将自己制作的网站发布到网上？  *服务器网站为何频现安全漏洞？  ,怎么在广州志愿者网站注册？  浅析上传头像示例及其注意事项  如何快速完成中国万网建站详细流程？  视频网站制作教程,怎么样制作优酷网的小视频？  宝塔建站后网页无法访问如何解决？  官网自助建站系统：SEO优化+多语言支持，快速搭建专业网站  建站之星后台密码如何安全设置与找回？  矢量图网站制作软件,用千图网的一张矢量图做公司app首页，该网站并未说明版权等问题，这样做算不算侵权？应该如何解决？  电视网站制作tvbox接口,云海电视怎样自定义添加电视源？  详解jQuery停止动画——stop()方法的使用  英语简历制作免费网站推荐,如何将简历翻译成英文？  如何在Tomcat中配置并部署网站项目？  c++23 std::expected怎么用 c++优雅处理函数错误返回【详解】  如何快速搭建自助建站会员专属系统？  如何在Golang中引入测试模块_Golang测试包导入与使用实践  如何彻底删除建站之星生成的Banner？  招贴海报怎么做,什么是海报招贴？  javascript基本数据类型及类型检测常用方法小结  如何选择PHP开源工具快速搭建网站？  如何在IIS中配置站点IP、端口及主机头？  建站之星图片链接生成指南：自助建站与智能设计教程  浅谈Javascript中的Label语句  在线制作视频的网站有哪些,电脑如何制作视频短片？  如何解决VPS建站LNMP环境配置常见问题？  定制建站是什么？如何实现个性化需求？  如何通过VPS建站无需域名直接访问？  建站之星五站合一营销型网站搭建攻略，流量入口全覆盖优化指南