如何配置 ASP.NET Core 应用程序?
在应用程序开发过程中,甚至在构建应用程序之后,您经常需要更改控制应用程序行为的各种设置。配置是指控制应用程序行为的外部值,包括应用程序在运行时使用的设置和参数。
存储配置值的最佳实践是在应用程序外部,而不是在源代码中硬编码。您不想每次更改配置时都重新编译并重新启动应用程序。这也存在安全隐患。您不想将数据库连接字符串或密码以纯文本形式存储在源代码中。
ASP.NET Core 使管理应用程序的配置变得非常容易。您可以通过各种来源(例如 JSON 文件、环境变量和命令行参数)配置设置。框架负责加载这些设置并通过统一的配置对象提供它们。它支持多种文件格式,如 JSON、XML、YAML 等。您还可以创建自己的自定义配置提供程序。该框架还允许您覆盖设置。
以下是 ASP.NET Core 支持的各种配置提供程序:
设置文件,如 appsettings.json
环境变量
Azure Key Vault
Azure App Configuration
命令行参数
自定义提供程序,已安装或创建
目录文件
内存中的 .NET 对象
Program 类中的 CreateDefaultBuilder() 方法提供默认配置。
public class Program{ public static void Main(string[] args){ CreateHostBuilder(args).Build().Run(); } public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); }); }
此方法按以下顺序加载配置:
ChainedConfigurationProvider
appsettings.json
appsettings.Environment.json
App secrets
Environment variables
Command-line arguments
如果您稍后添加任何其他配置提供程序,它们将覆盖先前的设置。
环境变量
EnvironmentVariablesConfigurationProvider 将环境变量中的配置值作为键值对加载。这是在读取 appsettings.json、appsettings.Environment.json 和用户机密后完成的。因此,环境变量中的设置将覆盖来自 appsettings.json 文件和用户机密的设置。
在 Windows 上,您可以使用 set 或 setx 命令设置环境变量。
set CONN_STR="Server=myServerAddress;Database=myDataBase;User Id=myUsername;Password=myPassword;"
命令行变量
通过命令行设置的配置设置将覆盖所有其他配置提供程序。它使用 CommandLineConfigurationProvider 从命令行参数加载配置作为键值对。例如:
dotnet run CONN_STR="Server=myServerAddress; Database=myDataBase; User Id=myUsername; Password=myPassword;"