Skip to content

全局设置

Db.Configure 会修改当前进程里 Db 门面使用的全局设置。后续新建的 builder 会读取这份设置并生成自己的参数快照,所以建议在应用启动阶段统一配置。

csharp
Db.Configure(new Db4NetSettings
{
    ParameterNamePrefix = "param",
    ReuseParameters = false,
    SqlCaptureMode = SqlCaptureMode.Never
});

选项说明

  • ParameterNamePrefix 控制自动生成参数名的前缀,默认值是 p。例如按主键查询时会生成类似 @p1 的参数。
  • ReuseParameters 控制是否复用相同值对应的参数名。默认值是 true,适合减少重复绑定。
  • SqlCaptureMode 控制异常里是否附带 SQL。开发调试时可以保留默认值 OnlyDebuggerAttached,上线后通常改成 Never

什么时候改

  • 你想统一整个应用的参数前缀时。
  • 你在调试阶段希望异常里带上 SQL 时。
  • 你需要让同值参数保持去重或强制独立时。