Dapper 使用 @参数名 作为参数占位符，SQL 中必须带 @ 前缀（如 @Id），C# 传参对象属性名不带 @（如 Id），大小写需一致；支持数组 IN 查询自动展开；复杂场景推荐 DynamicParameters。
Dapper 使用 @参数名 作为标准的参数占位符，这是它参数化查询的核心机制。@ 符号本身不是 SQL 语法的一部分，而是 Dapper 约定的命名前缀，用于将 C# 对象属性或匿名对象字段映射到 SQL 中的参数位置。
在写 SQL 字符串时，所有参数都必须显式以 @ 开头，比如：
SELECT * FROM Users WHERE Id = @Id AND Status = @StatusINSERT 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；大小写需完全一致（默认区分大小写）。
当需要更精细控制（比如输出参数、指定 DbType 或方向），推荐用 DynamicParameters：
parameters.Add("@UserId", 1001, DbType.Int32);parameters.Add("@Result", dbType: DbType.Int32, direction: ParameterDirection.Output);注意：这里 Add 方法的第一个参数是完整参数名（含 @），Dapper 会原样传递给底层 ADO.NET。这也是解决“必须声明标量变量 @xxx”错误的正确方式——别用原生 SqlParameter，改用 DynamicParameters。
Dapper 支持简洁的数组参数语法，无需手动展开：
WHERE Id IN @Ids
new { Ids = new[] { 1, 2, 3 } }
Dapper 会自动把数组转成 @Ids0, @Ids1, @Ids2 并绑定值，整个过程仍遵循 @ 命名规则，只是隐藏了拼接细节。
基本上就这些。记住关键点：SQL 里带 @，C# 里不带 @，大小写敏感，复杂场景用 DynamicParameters —— 不复杂但容易忽略。
以上就是Dapper怎么处理带@符号的参数名 Dapper参数命名规范的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告
收藏
收藏
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
607
