C#怎么使用Dapper Dapper连接数据库与查询方法

来源：这里教程网时间：2026-02-21 17:36:10 作者：

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()
，返回影响行数

示例：

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 并映射结果。