能否通过SqlClient自动获取查询字符串中定义的参数列表？

System.Data.SqlClient 没有提供任何公开的原生方法，可以直接传入SQL查询文本就输出识别到的参数列表，后续替代它的 Microsoft.Data.SqlClient 也没有这个能力。

你看到的参数校验报错的本质 #

你观察到的参数缺失抛错逻辑，根本不是客户端SqlClient本地实现的：

• 当你调用SqlCommand的执行方法（比如ExecuteReader）时，SqlClient只会把你写的SQL文本、已经手动加入Parameters集合的参数打包，发送给SQL Server服务端。
• 参数识别、参数匹配校验的逻辑全部在SQL Server数据库引擎侧完成：服务端解析SQL、生成执行计划时，如果发现SQL里的参数占位符没有对应的传入值，才会生成错误信息返回给客户端，由客户端抛出你看到的异常。
• 因为参数解析能力根本不在客户端SqlClient库内，自然不会暴露对应的公开提取方法。

现有自实现逻辑的注意事项 #

你当前通过遍历字符串匹配@开头标识符提取参数的逻辑，要注意避开误判场景：

• SQL注释（单行--、多行/* */）里的@开头字符串
• 字符串常量（单引号包裹的内容）里的@开头内容
• 以上场景的内容都不是实际需要传入的查询参数，简单正则匹配很容易把这些内容识别成参数。

另外就算你能准确提取所有参数名，也无法仅通过SQL文本自动判定参数的数据类型——参数类型是和数据库侧的表字段、表达式计算结果绑定的，SQL文本本身不携带类型信息，这也是为什么你现在需要用户手动定义参数类型的核心原因。

自动获取参数及类型的可行方案 #

如果要省去手动定义参数的步骤，可以通过SQL Server自带的系统存储过程实现，不需要自己维护解析逻辑：

1. 连接到目标SQL Server数据库
2. 调用系统存储过程sys.sp_describe_undeclared_parameters，传入待解析的SQL文本作为参数
3. 读取存储过程返回的结果集，里面包含所有未声明参数的名称、建议系统类型ID、长度、精度等信息，你可以直接用这些信息自动生成SqlParameter集合

核心调用代码示例：

using SqlConnection conn = new SqlConnection("你的数据库连接字符串");
conn.Open();
SqlCommand cmd = new SqlCommand("sys.sp_describe_undeclared_parameters", conn);
cmd.CommandType = CommandType.StoredProcedure;
cmd.Parameters.AddWithValue("@tsql", "你要解析的参数化查询SQL文本");

using SqlDataReader reader = cmd.ExecuteReader();
while (reader.Read())
{
    string paramName = reader.GetString(reader.GetOrdinal("name"));
    byte typeId = reader.GetByte(reader.GetOrdinal("suggested_system_type_id"));
    // 此处可将typeId映射为对应SqlDbType，自动构造参数加入命令对象
}

注意这个存储过程仅支持SQL Server 2012及以上版本，返回的是服务端推断的建议类型，遇到参数对应多表同名字段类型不一致、参数参与隐式类型转换等场景时，可能需要手动调整类型映射。

内容的提问来源于stack exchange，提问作者Simon Worth