C#如何简化Dapper的CRUD操作？Dapper Contrib使用方法详解

在C#项目开发中，Dapper凭借轻量、高性能的特点成为很多开发者的首选ORM框架，但原生Dapper执行CRUD操作需要手动编写SQL语句，当实体类属性较多时，拼接SQL的工作量会明显增大。Dapper Contrib是Dapper的官方扩展库，通过特性标注和内置方法，让开发者无需编写SQL就能完成基础的CRUD操作，大幅简化开发流程。

Dapper Contrib安装

首先需要在项目中安装Dapper Contrib依赖，可以通过NuGet包管理器执行以下命令安装：

Install-Package Dapper.Contrib

安装完成后，框架会自动依赖Dapper，无需额外安装Dapper核心包。

实体类特性标注

Dapper Contrib通过特性来识别实体类与数据库表的映射关系，常用的特性如下：

• Table：指定实体类对应的数据库表名，若表名和类名一致可省略
• Key：标记主键字段，支持自增主键和非自增主键
• ExplicitKey：标记非自增的主键字段，比如GUID类型的主键
• Computed：标记计算字段，执行插入和更新操作时会忽略该字段
• Write：标记是否允许写入，设置为false时插入和更新操作会忽略该字段

以下是一个实体类的标注示例：

using Dapper.Contrib.Extensions;

// 指定对应数据库表名为Users
[Table("Users")]
public class User
{
    // 自增主键标注Key
    [Key]
    public int Id { get; set; }
    
    // 普通字段，默认会映射到同名字段
    public string UserName { get; set; }
    
    public string Email { get; set; }
    
    // 计算字段，插入更新时忽略
    [Computed]
    public string FullInfo { get; set; }
}

核心CRUD方法使用

Dapper Contrib的CRUD方法都扩展在IDbConnection接口上，需要先创建数据库连接，再调用对应方法。

插入操作

插入单个实体使用Insert方法，插入多个实体使用InsertAsync的批量重载，方法会返回插入的主键ID：

using Dapper.Contrib.Extensions;
using System.Data.SqlClient;

// 创建数据库连接
using IDbConnection connection = new SqlConnection("Server=127.0.0.1;Database=TestDB;Uid=sa;Pwd=123456");

// 插入单个实体
var user = new User { UserName = "张三", Email = "zhangsan@ipipp.com" };
int newId = connection.Insert(user);
Console.WriteLine($"插入成功，主键ID为：{newId}");

// 批量插入
var userList = new List<User>
{
    new User { UserName = "李四", Email = "lisi@ipipp.com" },
    new User { UserName = "王五", Email = "wangwu@ipipp.com" }
};
connection.Insert(userList);

查询操作

查询方法分为查询单个、查询全部和根据条件查询：

// 根据主键查询单个实体
var queryUser = connection.Get<User>(1);

// 查询所有实体
var allUsers = connection.GetAll<User>().ToList();

// 异步查询示例
var asyncUser = await connection.GetAsync<User>(2);

更新操作

更新操作使用Update方法，会根据主键匹配更新对应记录：

var updateUser = connection.Get<User>(1);
updateUser.UserName = "张三更新";
updateUser.Email = "zhangsan_update@ipipp.com";
bool isSuccess = connection.Update(updateUser);
Console.WriteLine($"更新结果：{isSuccess}");

删除操作

删除支持按实体删除和按主键删除两种方式：

// 按实体删除
var deleteUser = connection.Get<User>(1);
connection.Delete(deleteUser);

// 按主键删除
connection.Delete<User>(2);

// 删除所有记录
connection.DeleteAll<User>();

注意事项

• Dapper Contrib默认会映射实体类所有公共属性到数据库字段，若字段名不一致可以通过特性或者自定义映射处理
• 自增主键标注Key即可，非自增主键比如GUID需要标注ExplicitKey，否则插入时会报错
• 执行操作时确保数据库连接是打开状态，或者让Dapper自动管理连接状态
• 复杂的联表查询场景还是建议使用原生Dapper编写SQL，Dapper Contrib更适合简单的基础CRUD场景

C#Dapper_ContribCRUD操作ORM修改时间：2026-07-11 17:30:29