Dapper怎么使用Dapper.Contrib进行CRUD Dapper.Contrib快速操作指南-C#.Net教程-PHP中文网

Dapper怎么使用Dapper.Contrib进行CRUD Dapper.Contrib快速操作指南

幻夢星雲

发布： 2025-12-19 09:29:50

原创

639人浏览过

Dapper.Contrib 可实现免手写 SQL 的高性能 CRUD，需安装 Dapper 和 Dapper.Contrib 包、引入命名空间、实体标记 [Table] 和 [Key] 特性，并调用 Get/GetAll/Insert/Update/Delete 等扩展方法。

dapper怎么使用dapper.contrib进行crud dapper.contrib快速操作指南

直接用 Dapper.Contrib 就能绕过手写 SQL，实现接近原生 Dapper 性能的 CRUD 操作，关键在实体标记和方法调用——不复杂但容易忽略细节。

安装与基础引用

先通过 NuGet 安装两个包（缺一不可）：

dotnet add package Dapper
dotnet add package Dapper.Contrib

代码中必须同时引入命名空间：

using Dapper;
using Dapper.Contrib.Extensions;

实体类要加特性标记

Dapper.Contrib 不靠约定猜表名或主键，而是依赖特性显式声明。最简配置示例如下：

[Table("Users")]<br>public class User<br>{<br>    [Key]<br>    public int Id { get; set; }<br>    public string Name { get; set; }<br>    public DateTime CreatedAt { get; set; }<br>}

登录后复制

注意点：

[Table] 必须指定数据库表名，不能省略
[Key] 标识主键字段，仅一个字段可用；若主键非自增或需手动赋值，可加 [ExplicitKey]
[Computed] 用于数据库计算列（如 GETDATE()），插入/更新时自动跳过
不加任何标记的属性默认参与插入和更新

四大核心方法直接上手

所有方法都是 IDbConnection 的扩展，连接打开后即可调用：

Dream Machine

Dream Machine 是由 Luma AI 开发的一款 AI 视频生成工具，可以快速将文本和图像转换为高质量的视频内容。

165

查看详情

查单条：connection.Get<user>(1)</user> → 等效 SELECT * FROM Users WHERE Id = @Id
查全部：connection.GetAll<user>()</user> → 返回 IEnumerable<user></user>
插一条：int newId = connection.Insert(new User { Name = "Alice" }); → 自增主键自动返回，非自增则返回影响行数
删/改：connection.Update(user) 或 connection.Delete(user)，都按 [Key] 字段匹配操作