Dapper调用存储过程需明确三点：指定CommandType.StoredProcedure、正确传参（匿名对象或DynamicParameters）、选用合适执行方法（Query/Execute/QueryMultiple）；支持异步与事务，关键在细节准确。
Dapper调用存储过程其实很直接，关键在于三点：指定 CommandType.StoredProcedure、传对参数类型、选对执行方法（Query / Execute / QueryMultiple）。它不封装 SQL Server 的复杂性，但把底层细节控制权交给你，所以写法清晰、性能好、不易出错。
基础调用：无参或仅输入参数
最常见场景，比如查用户列表或更新单条记录。Dapper 支持用匿名对象传参，简洁高效：
- 连接打开后，直接调用
Query（查数据）或() Execute()（增删改） - 必须显式指定
commandType: CommandType.StoredProcedure - 参数用匿名对象即可，字段名要和存储过程中定义的参数名完全一致（大小写不敏感，但建议保持一致）
示例：
using (var conn = new SqlConnection(connStr))
{
conn.Open();
var users = conn.Query("sp_GetUsersByStatus",
new { Status = 1 },
commandType: CommandType.StoredProcedure).ToList();
}
带输出参数：必须用 DynamicParameters
Dapper 原生不支持从匿名对象读取 OUTPUT 或 RETURN 参数，这时得用 DynamicParameters 类——它是 Dapper 提供的可变参数容器。
- 每个
Add()调用需明确指定参数名、值、DbType、ParameterDirection - 输出参数的值在执行后通过
Get方法提取() - 注意：
OUTPUT参数在调用前可不赋初值，但RETURN参数需设direction: ParameterDirection.ReturnValue
示例：
var dp = new DynamicParameters();
dp.Add("@UserId", 1001, DbType.Int32, ParameterDirection.Input);
dp.Add("@Msg", dbType: DbType.String, size: 200, direction: ParameterDirection.Output);
dp.Add("@ResultCode", dbType: DbType.Int32, direction: ParameterDirection.ReturnValue);
conn.Execute("sp_UpdateUserWithLog", dp, commandType: CommandType.StoredProcedure);
string msg = dp.Get("@Msg");
int code = dp.Get("@ResultCode");
返回多个结果集：用 QueryMultiple
一个存储过程里如果写了多条 SELECT（比如先查用户再查其角色），Dapper 不会自动合并，要用 QueryMultiple 分步读取。
- 调用后得到一个
GridReader对象 - 每调一次
.Read就消费一个结果集，顺序必须和存储过程中() SELECT的顺序一致 - 支持不同泛型类型，比如
Read和() Read()
示例：
using (var multi = conn.QueryMultiple("sp_GetUserAndRoles",
new { UserId = 123 },
commandType: CommandType.StoredProcedure))
{
var user = multi.Read().FirstOrDefault();
var roles = multi.Read().ToList();
}
异步调用与事务配合
Dapper 所有核心方法都有异步版本（QueryAsync、ExecuteAsync、QueryMultipleAsync），适合高并发 Web 场景。
- 异步调用时，输出参数仍可用
DynamicParameters，执行完再取值 - 若需事务控制，把连接和事务对象一起传入（
transaction参数），存储过程会在同一事务上下文中运行 - 注意：事务必须由你手动
BeginTransaction()，并负责Commit()或Rollback()
示例（事务中执行两个存储过程）：
using (var conn = new SqlConnection(connStr))
{
await conn.OpenAsync();
using var tx = await conn.BeginTransactionAsync();
try
{
await conn.ExecuteAsync("sp_CreateOrder", orderParams, tx, commandType: CommandType.StoredProcedure);
await conn.ExecuteAsync("sp_SendNotification", notifyParams, tx, commandType: CommandType.StoredProcedure);
await tx.CommitAsync();
}
catch
{
await tx.RollbackAsync();
throw;
}
}
基本上就这些。Dapper 调用存储过程不复杂但容易忽略细节——比如漏写 CommandType.StoredProcedure、混淆 Output 和 ReturnValue、或多结果集读取顺序错乱。按场景选对方法，参数配准类型，基本不会踩坑。
