C#怎么调用带有输出参数的存储过程_C#如何获取SQL返回值【实战】-C#.Net教程-PHP中文网

sqlcommand传out参数需显式设direction=output且初始化value（如dbnull.value），执行后读取；多结果集须遍历完nextresult()再读输出参数；returnvalue为int型独立返回码，与output参数不可混淆。

c#怎么调用带有输出参数的存储过程_c#如何获取sql返回值【实战】

SqlCommand怎么传`out`参数并读取值

直接用 SqlParameter 指定方向为 ParameterDirection.Output，别漏掉 Value 初始化（哪怕只是 null 或默认值），否则执行时报错 Procedure or function 'xxx' expects parameter '@yyy', which was not supplied.

SqlParameter 必须显式设置 Direction = ParameterDirection.Output，不设默认是 Input
Value 字段不能留空——哪怕输出参数不需要输入值，也得给个占位值，比如 DBNull.Value、0 或 string.Empty
执行完 cmd.ExecuteNonQuery() 后，才能读 param.Value，提前读是初始值，不是数据库返回的
如果存储过程中该参数被赋了 NULL，读出来是 DBNull.Value，不是 null（C# null），注意判空用 == DBNull.Value

var param = new SqlParameter("@retCode", SqlDbType.Int) {
    Direction = ParameterDirection.Output,
    Value = 0 // 必须设，不能为 null
};
cmd.Parameters.Add(param);
cmd.ExecuteNonQuery();
int code = (int)param.Value; // 执行后才有效

如何同时拿到输出参数和查询结果集

输出参数和 SqlDataReader 可以共存，但顺序很重要：必须先读完所有结果集（调用 reader.NextResult() 直到返回 false），再读输出参数。否则可能因连接未完全释放导致值没更新。

用 ExecuteReader() 而不是 ExecuteNonQuery()，即使你只想要输出参数——只要存储过程里有 SELECT，就得走 reader 流程
必须循环调用 reader.NextResult()，直到它返回 false，才算真正“收尾”了整个结果流
输出参数的值在最后一次 NextResult() 返回 false 后才最终就绪，这时候读才准
如果存储过程返回多个结果集（比如两个 SELECT），不遍历完，输出参数可能仍是旧值或未赋值

存储过程返回`RETURN`值 vs `OUTPUT`参数的区别

SQL Server 的 RETURN 值只能是 int，且必须用 SqlParameter 以 ParameterDirection.ReturnValue 接收；而 OUTPUT 参数支持任意类型，更灵活，但容易和 RETURN 混用出错。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

RETURN 不是结果集，也不是输出参数，它是独立的整数返回码，对应 SqlParameter 的 Direction = ParameterDirection.ReturnValue
一个存储过程最多一个 RETURN 值，但可以有多个 OUTPUT 参数
如果误把 OUTPUT 参数当成 ReturnValue 读，会得到 0 或随机值；反过来，漏掉 ReturnValue 参数，RETURN 值就丢了，且不会报错
RETURN 值在 ExecuteNonQuery() 或 ExecuteReader() 返回后立即可用，不用等结果集读完

var retParam = new SqlParameter("@ret", SqlDbType.Int) {
    Direction = ParameterDirection.ReturnValue
};
cmd.Parameters.Add(retParam);
cmd.ExecuteNonQuery();
int status = (int)retParam.Value; // 这里就能读，不依赖结果集

常见类型转换失败和 NULL 处理陷阱

输出参数从 SQL 到 C# 的类型映射不是自动“聪明”的，尤其遇到 NULL、varchar(max)、datetime2 时，Value 可能是 DBNull.Value 或底层 object，硬转会抛 InvalidCastException。

永远先检查 param.Value == DBNull.Value，再做类型转换，别直接 (string)param.Value
DateTime 输出参数如果可能为 NULL，建议声明为 DateTime?，然后用 param.Value as DateTime?
varchar/nvarchar 类型输出参数，Value 是 string 没问题；但如果是 text 或 varchar(max)，某些旧驱动可能返回 SqlString，需调用 .ToString()
用 SqlDbType 显式指定参数类型（如 SqlDbType.VarChar），比依赖推断更稳，尤其当存储过程里用 CONVERT 或拼接影响类型推导时