Dapper 是轻量级高性能 .NET ORM，基于 ADO.NET 封装，不生成 SQL，专注参数化查询与结果映射；支持多数据库、动态对象、多结果集、事务及异步操作，需手动管理连接与事务。
Dapper 是一个轻量级、高性能的 .NET ORM（对象关系映射）库，它不替代 ADO.NET，而是在其基础上封装了常用操作，让 SQL 查询更简洁、类型更安全。它不生成 SQL，也不做复杂映射，核心是“用最简方式把 SQL 结果映射成对象”。下面直接讲怎么用——以 SQL Server 为例，其他数据库（如 MySQL、PostgreSQL）只需换连接字符串和驱动即可。
安装 Dapper 和数据库驱动
在项目中通过 NuGet 安装：
-
Dapper：核心库，提供扩展方法（如
Query<t>()</t>、Execute()） -
Microsoft.Data.SqlClient（推荐）或
System.Data.SqlClient（旧版）：SQL Server 官方驱动 - 如果是 MySQL，装
Pomelo.EntityFrameworkCore.MySql或MySqlConnector+ Dapper；PostgreSQL 用Npgsql
基础连接与查询（单对象/列表）
所有操作都基于 IDbConnection。Dapper 通过扩展方法注入功能，不需要继承或配置上下文。
- 创建连接：用
new SqlConnection(connectionString)，建议配合using确保释放 - 查单条：用
QueryFirstOrDefault<t>()</t>（没结果返回 null）或QuerySingle<t>()</t>（必须有且仅1条，否则异常） - 查多条：用
Query<t>()</t>，返回IEnumerable<t></t>，可转.ToList() - 执行非查询（增删改）：用
Execute()，返回影响行数
示例：
outlook-microsoft
下载
微软 Outlook 邮箱和日历管理工具（支持世纪互联版 Office 365）。用于查看、发送、搜索邮件，管理日历日程，创建会议，查询忙闲状态。注意：此功能仅支持世纪互联（21Vianet）版 Microsoft 365，使用 login.chinacloudapi.cn。
string connStr = "Server=.;Database=testdb;Trusted_Connection=true;";
using var conn = new SqlConnection(connStr);
conn.Open();
<p>// 查询用户列表
var users = conn.Query<User>("SELECT * FROM Users WHERE Age > @age", new { age = 18 }).ToList();</p><p>// 查询单个用户
var user = conn.QueryFirstOrDefault<User>("SELECT * FROM Users WHERE Id = @id", new { id = 1 });</p><p>// 插入
int rows = conn.Execute("INSERT INTO Users (Name, Age) VALUES (@name, @age)",
new { name = "张三", age = 25 });
参数化查询与动态对象支持
Dapper 原生支持命名参数（@xxx），自动匹配匿名对象或强类型对象的属性名，大小写敏感但不区分数据库字段别名大小写（取决于数据库本身）。
- 传参推荐用匿名对象（
new { a = 1, b = "x" }）或实体类实例，避免字符串拼接防 SQL 注入 - 查未知结构数据？用
Query<dynamic>()</dynamic>，返回IDictionary<string object></string>风格的动态对象，属性名即列名 - 多结果集（如一次返回用户+订单）？用
QueryMultiple()+Read<t>()</t>分步读取
事务与异步支持
Dapper 完全兼容 ADO.NET 的事务和 async/await。
- 事务：用
conn.BeginTransaction()，传给Query()或Execute()的transaction参数 - 异步方法：所有主方法都有对应异步版本，如
QueryAsync<t>()</t>、ExecuteAsync()、QueryMultipleAsync() - 注意：异步方法需调用方
await，连接也建议用OpenAsync()
示例事务：
using var conn = new SqlConnection(connStr);
await conn.OpenAsync();
using var tx = conn.BeginTransaction();
try
{
await conn.ExecuteAsync("INSERT ...", new { ... }, tx);
await conn.ExecuteAsync("UPDATE ...", new { ... }, tx);
tx.Commit();
}
catch
{
tx.Rollback();
throw;
}
基本上就这些。Dapper 不复杂但容易忽略细节：比如参数名必须严格匹配、连接要自己管理生命周期、没有迁移或实体跟踪——它只做一件事：快而稳地跑 SQL 并映射结果。
