Dapper如何执行带输出参数的存储过程 Dapper Output参数用法

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

Dapper 本身不直接支持 SQL Server 的 OUTPUT 参数（即存储过程中用

OUTPUT

关键字返回的参数），但它完全支持 ADO.NET 风格的输出参数（
SqlParameter
with
Direction = ParameterDirection.Output
）。也就是说，如果你的存储过程定义了

OUTPUT

类型的参数（比如

@ResultID INT OUTPUT

），Dapper 可以通过传入带方向的

SqlParameter

来获取其返回值。

使用 SqlParameter 显式声明 Output 参数

这是最常用、最可靠的方式。你需要手动创建

SqlParameter

，设置

ParameterDirection.Output

或

InputOutput

，再传给 Dapper 方法。

确保参数名与存储过程中定义的名称完全一致（包括 @ 符号） 输出参数的
Value
初始值可以为
DBNull.Value
或任意占位值（Dapper 不读取它的输入值，但 ADO.NET 要求非 null 引用）执行后从
param.Value
中读取结果，注意类型转换（如
(int)param.Value
）

示例（C#）：

var idParam = new SqlParameter("@ResultID", SqlDbType.Int) { Direction = ParameterDirection.Output };
var nameParam = new SqlParameter("@Name", "张三") { Direction = ParameterDirection.Input };
connection.Execute("sp_InsertUser", new[] { idParam, nameParam }, commandType: CommandType.StoredProcedure);
int newId = (int)idParam.Value; // 获取输出值

用 DynamicParameters 简化 Output 参数管理

Dapper.DynamicParameters

是 Dapper 提供的增强型参数容器，对 Input/Output/ReturnValue 参数支持更友好，语法也更简洁。

用
Add()
方法添加参数时，指定
dbType
、
direction
和可选的
value
执行后调用
Get<t>("paramName")</t>
获取输出值（推荐），或直接访问
parameters.Get<dynamic>("paramName")</dynamic>
支持多个输出参数，也兼容返回值（
ParameterDirection.ReturnValue
）

示例：

var p = new DynamicParameters();
p.Add("@Name", "李四", DbType.String, ParameterDirection.Input);
p.Add("@UserId", dbType: DbType.Int32, direction: ParameterDirection.Output);
p.Add("@ReturnCode", dbType: DbType.Int32, direction: ParameterDirection.ReturnValue);
connection.Execute("sp_InsertUser", p, commandType: CommandType.StoredProcedure);
int userId = p.Get<int>("@UserId");
int returnCode = p.Get<int>("@ReturnCode");

注意：Output 参数 ≠ OUTPUT 子句（SQL Server 的 INSERT...OUTPUT）

别混淆两个概念：

OUTPUT 参数：存储过程定义的带
OUTPUT
关键字的 T-SQL 参数，属于“过程级返回值”，需用
SqlParameter.Direction = Output
捕获 INSERT...OUTPUT 子句：SQL 语句级功能，用于返回被插入/更新/删除的行数据（如
OUTPUT INSERTED.Id
）。Dapper 对它天然支持——只要你的存储过程里写了
SELECT
或直接
OUTPUT
返回结果集，Dapper 就能用
Query<t>()</t>
接收，无需特殊参数设置

常见问题提醒

存储过程必须用
commandType: CommandType.StoredProcedure
，否则参数名匹配可能失败 SQL Server 中 OUTPUT 参数默认是
NULL
，务必在存储过程中显式赋值（如
SET @ResultID = SCOPE_IDENTITY()
）如果输出参数是字符串，建议指定
Size
（如
Size = 50
），避免截断或长度推断异常 Dapper 不支持匿名对象自动映射 Output 参数（比如
new { @Name = "a", @Id = Output }
），必须用
DynamicParameters
或原生
SqlParameter

基本上就这些。用好