如何配置 ASP.NET Core 应用程序?

asp.netserver side programmingprogramming

在应用程序开发过程中,甚至在构建应用程序之后,您经常需要更改控制应用程序行为的各种设置。配置是指控制应用程序行为的外部值,包括应用程序在运行时使用的设置和参数。

存储配置值的最佳实践是在应用程序外部,而不是在源代码中硬编码。您不想每次更改配置时都重新编译并重新启动应用程序。这也存在安全隐患。您不想将数据库连接字符串或密码以纯文本形式存储在源代码中。

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;"

相关文章