[Table] 和 [Key] 是 Dapper.Contrib 中用于实体映射的核心特性：[Table] 标注类以指定对应数据库表名，避免默认复数推导错误；[Key] 标注自增主键属性，插入时忽略该字段并回填生成值；非自增主键须用[ExplicitKey]。
![dapper中[key]和[table]特性有什么用 dapper.contrib特性详解](https://www.chuangxiangniao.com/wp-content/uploads/2025/12/176590339037877.png)
[Table] 和 [Key] 是 Dapper.Contrib 中用于实体类映射的核心特性，它们不参与 Dapper 本体（纯 SQL 扩展）的运行，只在 Dapper.Contrib 提供的高级 CRUD 方法（如 Insert、Get、Update）中起作用。
Table 特性：告诉 Dapper.Contrib “这张表叫什么”
它标注在类上，明确指定该实体对应数据库中的哪张物理表。如果不加，Dapper.Contrib 会按约定自动推导：把类名变成复数形式（比如 User → Users），容易出错或不匹配。
必须是类级别，不能标在属性或方法上 值就是真实表名，支持带 schema，例如 [Table("dbo.Customers")] 如果数据库表名含特殊字符或大小写敏感，加 [Table] 是最稳妥的做法
Key 特性：声明“这个字段是自增主键”
它标注在某个属性上，表示该字段是数据库中自动增长（IDENTITY）类型的主键，比如 int 或 long 类型的 ID 列。
插入时，Dapper.Contrib 会自动忽略该字段的值，不把它放进 INSERT 语句的列和参数列表里 插入成功后，会把数据库生成的新主键值回填到对象的该属性中（仅限数字类型） 不能和 [ExplicitKey] 同时用在一个属性上
对比 ExplicitKey：非自增主键的正确写法
如果你的主键是 Guid、字符串或由程序生成的值（比如雪花 ID），就得用 [ExplicitKey]，而不是 [Key]。
[ExplicitKey] 表示“这个主键值我来提供”，插入时会包含该字段 比如 Guid ID { get; set; } = Guid.NewGuid();，加上 [ExplicitKey] 才能正确入库 误用 [Key] 会导致插入失败或主键为 0/空
常见搭配建议
SQL Server 自增 int 主键 → [Key] PostgreSQL 序列主键（SERIAL）→ 也适用 [Key] MySQL 的 AUTO_INCREMENT int 主键 → [Key] 所有 GUID / 字符串 / 程序生成主键 → 必须用 [ExplicitKey] 表名与类名不一致（尤其大小写、下划线、前缀等）→ 一律加 [Table("xxx")]
基本上就这些。用对这两个特性，Dapper.Contrib 的增删改查才能按预期工作，否则很容易出现“插不进”“查不到”“主键丢失”之类的问题。
以上就是Dapper中[Key]和[Table]特性有什么用 Dapper.Contrib特性详解的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1443200.html
微信扫一扫 
支付宝扫一扫 
