使用SqlCommand.Parameters时如何获取可直接执行的最终SQL语句

首先明确核心事实：ADO.NET 原生的 SqlClient 不存在直接获取参数完全替换后可执行SQL的内置方法。
原因很简单：参数化查询执行时，客户端驱动是把SQL命令文本、参数集合分开发送给SQL Server服务端的，参数值替换为字面量的过程完全在数据库引擎侧完成，客户端从来不会生成"拼接好参数的完整SQL"，自然也没有现成的属性或方法可以直接拿到这个值，SQL Profiler里展示的语句是服务端解析执行后反向输出的结果，不是客户端传过去的内容。

如果你的需求是在业务代码里记录可直接复制运行的SQL日志，不需要额外去服务端抓trace，自己实现一个参数拼接逻辑即可，不需要处理太复杂的场景，只要覆盖常见类型的转义规则就行，实现成本很低。

可直接复用的实现方案 #

给SqlCommand写一个扩展方法，遍历参数集合按照类型规则生成对应的字面量，再替换命令文本里的占位符即可：

public static class SqlCommandExtensions
{
    /// <summary>
    /// 生成可直接执行的完整SQL语句
    /// </summary>
    public static string GetRunnableSql(this SqlCommand command)
    {
        if (command == null) throw new ArgumentNullException(nameof(command));
        string sqlText = command.CommandText;
        
        foreach (SqlParameter param in command.Parameters)
        {
            string valueLiteral;
            // 处理空值
            if (param.Value == null || param.Value == DBNull.Value)
            {
                valueLiteral = "NULL";
            }
            else
            {
                // 按类型处理字面量格式
                switch (param.DbType)
                {
                    case DbType.String:
                    case DbType.AnsiString:
                    case DbType.StringFixedLength:
                    case DbType.AnsiStringFixedLength:
                    case DbType.Date:
                    case DbType.DateTime:
                    case DbType.DateTime2:
                    case DbType.DateTimeOffset:
                    case DbType.Guid:
                        // 字符串、日期、GUID类型需要包裹单引号，同时转义内部的单引号
                        valueLiteral = $"'{param.Value.ToString().Replace("'", "''")}'";
                        break;
                    case DbType.Boolean:
                        // SQL Server里bit类型用1/0表示
                        valueLiteral = (bool)param.Value ? "1" : "0";
                        break;
                    default:
                        // 数值、二进制等类型直接输出字符串即可
                        valueLiteral = param.Value.ToString();
                        break;
                }
            }
            // 用正则匹配完整参数名，避免@Id误替换@Id2这类部分匹配问题
            sqlText = Regex.Replace(
                input: sqlText, 
                pattern: $@"@{Regex.Escape(param.ParameterName)}(\b|$)", 
                replacement: valueLiteral, 
                options: RegexOptions.IgnoreCase);
        }

        return sqlText;
    }
}

调用方式 #

在原有代码里，参数添加完成后、执行Fill之前直接调用扩展方法就行：

DataTable dt = new DataTable();
query = "SELECT Name FROM TABLE WHERE Id = @Id";

using (SqlDataAdapter da = new SqlDataAdapter(query, String.Format(@"Data Source={0};Initial Catalog={1};Integrated Security=SSPI", relServer, relDatabase)))
{
    if (QueryParams != null && QueryParams.Count > 0)
    {
        foreach (KeyValuePair<string, object> entry in QueryParams)
        {
            da.SelectCommand.Parameters.AddWithValue(entry.Key, entry.Value ?? DBNull.Value);
        }
    }
    // 拿到可直接运行的SQL，用于日志记录
    string runnableSql = da.SelectCommand.GetRunnableSql();
    da.Fill(dt);
}

注意事项 #

• 不要用简单的string.Replace做参数替换，很容易出现参数名部分匹配的错误，比如参数@Id会误把@IdCard里的前缀替换掉，用正则匹配单词边界可以完全避免这个问题。
• 这个方法生成的SQL和SQL Profiler抓到的执行语句效果完全一致，可以直接复制到SSMS里运行，不需要额外调整。
• 如果是临时调试场景，也可以直接用SQL Server的扩展事件或Profiler抓服务端执行语句，但这种方式不适合集成到业务代码里做常规日志记录。

内容的提问来源于stack exchange，提问作者Pavel Sedina