Skip to main content

1. 应用配置

配置智能提示和校验

如需编写配置的时候提供智能提示和校验，可查看 【2.15 JSON Schema 使用】

只需要在 .json 文件头部添加下列配置即可：

{
  "$schema": "https://gitee.com/dotnetchina/Furion/raw/v4/schemas/v4/furion-schema.json"
}

1.1 关于配置​

应用配置指的是 Furion 框架全局配置选项。

1.2 配置信息​

  • AppSettings：配置根节点
    • InjectMiniProfiler：是否注入 MiniProfiler，bool 类型，默认 true，关闭 Swagger 左上角监听，Furion 4.9.7.75 版本中已移除
    • InjectSpecificationDocument：是否启用 Swagger 文档，bool 类型，默认 true，生产环境可关闭
    • EnabledReferenceAssemblyScan：是否启用通过 dll 方式添加的引用程序集扫描，bool 类型，默认 false
    • ExternalAssemblies：配置外部程序集完整路径，支持动态加载，string[] 类型，默认 []
    • ExcludeAssemblies：排除扫描的程序集名称，string[] 类型，默认 []
    • PrintDbConnectionInfo：是否打印数据库连接信息到 MiniProfiler 中，bool 类型，默认 true，Furion 4.9.7.75 版本中已移除
    • SupportPackageNamePrefixs：配置支持的包前缀名，string[] 类型，默认 []
    • OutputOriginalSqlExecuteLog：是否输出原始 Sql 执行日志（ADO.NET），默认 true
    • VirtualPath：配置虚拟目录，必须以 / 开头
    • JsonFileScanner：JSON 文件扫描配置，JsonFileScanner 类型，Furion 4.9.7.105+ 版本支持
      • Optional：是否可选，bool 类型
      • ReloadOnChange：是否改变的时候重载，bool 类型（配置 false 可解决部分 docker 启动慢的问题）
    • DisableAppStartupScan：是否禁用 AppStartup 自动扫描，bool 类型，默认 false，Furion 4.9.7.122+ 版本支持

1.3 配置示例​

{
  "AppSettings": {
    "InjectSpecificationDocument": true
  }
}

1.4 特别注意​

默认情况下，Furion 框架会自动扫描根目录下的 *.json 和 *.config.xml 文件载入配置中，如需忽略个别文件，需在 appsettings.json 配置文件根节点下配置 IgnoreConfigurationFiles 节点即可，string[] 类型，如：

{
  "IgnoreConfigurationFiles": ["runtime.json"]
}

如果需要自定义扫描目录（非根目录），需在 appsettings.json 中添加下面配置：

支持版本

在 v2.16.7+ 版本有效

{
  "ConfigurationScanDirectories": ["目录1名称", "目录1名称/子目录名称"]
}

必须在 appsettings.json 文件中配置才有效