[Table] 和 [Key] 是 Dapper.Contrib 中用于实体映射的核心特性：[Table] 标注类以指定对应数据库表名，避免默认复数推导错误；[Key] 标注自增主键属性，插入时忽略该字段并回填生成值；非自增主键须用[ExplicitKey]。
![dapper中[key]和[table]特性有什么用 dapper.contrib特性详解](https://img.php.cn/upload/article/001/221/864/176590339037877.png)
[Table] 和 [Key] 是 Dapper.Contrib 中用于实体类映射的核心特性，它们不参与 Dapper 本体（纯 SQL 扩展）的运行，只在 Dapper.Contrib 提供的高级 CRUD 方法（如 Insert、Get、Update）中起作用。
它标注在类上，明确指定该实体对应数据库中的哪张物理表。如果不加，Dapper.Contrib 会按约定自动推导：把类名变成复数形式（比如 User → Users），容易出错或不匹配。
[Table("dbo.Customers")]
[Table] 是最稳妥的做法它标注在某个属性上，表示该字段是数据库中自动增长（IDENTITY）类型的主键，比如 int 或 long 类型的 ID 列。
INSERT 语句的列和参数列表里[ExplicitKey] 同时用在一个属性上如果你的主键是 Guid、字符串或由程序生成的值（比如雪花 ID），就得用 [ExplicitKey]，而不是 [Key]。
[ExplicitKey] 表示“这个主键值我来提供”，插入时会包含该字段Guid ID { get; set; } = Guid.NewGuid();，加上 [ExplicitKey] 才能正确入库[Key] 会导致插入失败或主键为 0/空[Key]
SERIAL）→ 也适用 [Key]
AUTO_INCREMENT int 主键 → [Key]
[ExplicitKey]
[Table("xxx")]
基本上就这些。用对这两个特性，Dapper.Contrib 的增删改查才能按预期工作，否则很容易出现“插不进”“查不到”“主键丢失”之类的问题。
以上就是Dapper中[Key]和[Table]特性有什么用 Dapper.Contrib特性详解的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
557
收藏
