详解appsettings.json

一、什么是appsettings.json

appsettings.json是ASP.NET Core应用程序中的配置文件，它用于存储应用程序的配置信息。

在ASP.NET Core程序中，可以通过Configuration API读取appsettings.json文件中的配置信息。这些配置信息可以是应用程序的URL、数据库连接字符串、身份验证密钥、授权策略等。通过这样的配置方式，应用程序可以更简单地进行配置，并且可以在不修改代码的情况下进行更改。

二、如何使用appsettings.json

在使用appsettings.json之前，需要在程序的Startup.cs文件中添加如下代码：

public IConfiguration Configuration { get; }
public Startup(IConfiguration configuration)
{
    Configuration = configuration;
}

这里，我们将IConfiguration接口注入到了Startup类的构造函数中。这使得我们可以通过Configuration属性来访问配置。

接着，我们需要在Startup类的ConfigureServices方法中添加如下代码：

// 添加配置服务
services.AddSingleton(Configuration);

这样，我们就可以在任何地方使用Configuration属性来访问配置信息了。

三、配置文件格式

appsettings.json配置文件的格式非常简单明了。它是一个JSON格式的文本文件，包含一组键值对：

{
  "Key1": "Value1",
  "Key2": 2,
  "Key3": {
    "SubKey1": "Value2",
    "SubKey2": 3.5
  }
}

在上面的例子中，我们定义了三个配置项：

• Key1：其值为字符串类型的"Value1"
• Key2：其值为整数类型的2
• Key3：其值为一个嵌套的JSON对象

当然，配置文件中的键值对数量没有限制，可以根据具体需要进行自由组合。

四、使用appsettings.json的示例

1. 读取单个配置项

假设我们的配置文件中包含一个名为“Greeting”的配置项，其值为“Hello World”：

{
  "Greeting": "Hello World"
}

我们可以使用以下代码读取该配置项的值：

string greeting = Configuration["Greeting"];
Console.WriteLine(greeting); // 输出"Hello World"

2. 读取嵌套对象中的配置项

假设我们的配置文件中包含一个名为“Logging”的配置项，其值是一个嵌套的JSON对象，包含了多个子项：

{
  "Logging": {
    "LogLevel": "Warning",
    "LogFilePath": "/var/log/app.log"
  }
}

我们可以使用以下代码读取“Logging”对象中的“LogLevel”项的值：

string logLevel = Configuration["Logging:LogLevel"];
Console.WriteLine(logLevel); // 输出"Warning"

3. 使用强类型配置（POCO）

通过强类型配置，我们可以通过类的属性来访问配置：

public class MyAppSettings
{
    public string Greeting { get; set; }
    public int MaxItemCount { get; set; }
}

// 注册强类型配置
services.Configure
   (Configuration.GetSection("MyAppSettings"));

// 读取强类型配置
var settings = Configuration.GetSection("MyAppSettings").Get
    ();
Console.WriteLine(settings.Greeting); // 输出"Hello World"
    
   

在上面的示例中，我们定义了一个名为MyAppSettings的类，它包含了两个属性：Greeting（字符串类型）和MaxItemCount（整数类型）。

在Startup类的ConfigureServices方法中，我们使用了services.Configure方法来注册这个类，并指定了在配置文件中的键名为“MyAppSettings”。

在使用时，我们可以使用Configuration.GetSection方法获取配置，并使用Get方法将其转换为MyAppSettings类的实例。

五、总结

通过本文的介绍，我们了解了appsettings.json的基本使用方式和配置文件的格式，以及如何在ASP.NET Core应用程序中使用它来进行配置。