示例：ASP.NET MVC asp.net mvc已經內部實現了對配置appsettings.json文件的使用，builder預設支持熱更新。使用示例：假設appsettings.json內容為： { "Logging": { "LogLevel": { "Default": "Warnin ...

示例：ASP.NET MVC

asp.net mvc已經內部實現了對配置appsettings.json文件的使用，builder預設支持熱更新。

使用示例：

假設appsettings.json內容為：

    {
      "Logging": {
        "LogLevel": {
          "Default": "Warning"
        }
      },
      "AllowedHosts": "*"
    }

新建一個跟appsettings.json結構保持一致的類，如：

    namespace webapp.Models
    {
        public class AppsettingsModel
        {
            public Logging Logging { get; set; }

            public string AllowedHosts { get; set; }
        }

        public class Logging
        {
            public LogLevel LogLevel { get; set; }
        }

        public class LogLevel
        {
            public string Default { get; set; }
        }
    }

PS：

需要註意，用於IOptions或者IOptionsSnapshot中的模型的各個屬性，其setter必須是公共的，不能是私有。

另外對於該模型，必須要有一個無參構造函數。

在Startup.cs中進行依賴註入

        public void ConfigureServices(IServiceCollection services)
        {
            services.Configure<CookiePolicyOptions>(options =>
            {
                options.CheckConsentNeeded = context => true;
                options.MinimumSameSitePolicy = SameSiteMode.None;
            });
            // 依賴註入
            services.Configure<AppsettingsModel>(Configuration);
            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
        }

在controller中調用：

    public class TestController : Controller
    {
        private readonly AppsettingsModel _appsettingsModel;
        //若要使用熱更新，則入參調整為 IOptionsSnapshot<T>
        public TestController(IOptions<AppsettingsModel> appsettingsModel)
        {
            _appsettingsModel = appsettingsModel.Value;
        }

        public IActionResult Index()
        {
            return View("Index", _appsettingsModel.Logging.LogLevel.Default);
        }
    }

這裡需要註意一點，DI時，如果是單例，則無法使用是IOptionsSnapshot，會報錯。

如何覆寫預設行為？如取消熱更新支持，方法如下：

假設測試controller為

    public class TestController : Controller
    {
        private readonly AppsettingsModel _appsettingsModel;
        //使用的是：IOptionsSnapshot<T>
        public TestController(IOptionsSnapshot<AppsettingsModel> appsettingsModel)
        {
            _appsettingsModel = appsettingsModel.Value;
        }

        public IActionResult Index()
        {
            return View("Index", _appsettingsModel.Logging.LogLevel.Default);
        }
    }

Program.cs

    public class Program
    {
        public static void Main(string[] args)
        {
            CreateWebHostBuilder(args).Build().Run();
        }

        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .ConfigureAppConfiguration((context, config) => //1.通過該方法來覆蓋配置
                {
                    //2.重新添加json配置文件
                    config.AddJsonFile("appsettings.json", false, false); //3.最後一個參數就是是否熱更新的布爾值
                })
                .UseStartup<Startup>();
    }

這個時候，人為將熱更新給關閉了，此時更新json文件後，修改後的內容不會更新到系統中。

示例：控制台

對於console項目，預設是沒有這個dll的，需要自行從nuget安裝

從nuget中安裝：Microsoft.AspNetCore.All （註意，末尾不是dll，而是all）

在項目中引入：Microsoft.Extensions.Configuration; 並使用ConfigurationBuilder來構建配置。

使用應用程式參數

在控制台項目屬性中增加name和class參數：

使用：

class Program
{
    static void Main(string[] args)
    {
        var builder = new ConfigurationBuilder()
            .AddCommandLine(args);
        var configuration = builder.Build();

        Console.WriteLine($"name:{configuration["name"]}"); //name:CLS
        Console.WriteLine($"class:{configuration["class"]}");   //class:Class_A

        Console.Read();
    }
}

使用鍵值對枚舉（這裡以字典來說明）

    class Program
    {
                static void Main(string[] args)
                {
                    var dict = new Dictionary<string, string>
                    {
                        {"name","MC"},
                        {"class","CLASS_MC"}
                    };
                    var builder = new ConfigurationBuilder()
//                    .AddCommandLine(args)
                    .AddInMemoryCollection(dict);
        
                    var configuration = builder.Build();
        
                    Console.WriteLine($"name:{configuration["name"]}");//name:MC
                    Console.WriteLine($"class:{configuration["class"]}");  //class:CLASS_MC
        
                    Console.Read();
                }
    }

註意事項：

這裡需要註意下，雖然 AddCommandLine 和 AddInMemoryCollection 可以同時調用，但不同的使用次序，效果是不一樣的（後一個會覆蓋前一個的內容---淺覆蓋），如：

 /*
    假設 在項目屬性中，定義的內容為：name=CLS，class=CLASS_CLS，grade="mygrade"
    在代碼中，dict的內容為：name=MC，class=CLASS_MC
 */
//對於代碼：
var builder = new ConfigurationBuilder()
                    .AddCommandLine(args)
                    .AddInMemoryCollection(dict);
                    var configuration = builder.Build();
        
                    Console.WriteLine($"name:{configuration["name"]}");//name:MC
                    Console.WriteLine($"class:{configuration["class"]}");  //class:CLASS_MC
                    Console.WriteLine($"grade:{configuration["grade"]}");  //grade:mygrade
                    
//對於代碼：
var builder = new ConfigurationBuilder()                    
                    .AddInMemoryCollection(dict)
                    .AddCommandLine(args);
                    var configuration = builder.Build();
        
                    Console.WriteLine($"name:{configuration["name"]}");//name:CLS
                    Console.WriteLine($"class:{configuration["class"]}");  //class:CLASS_CLS
                    Console.WriteLine($"grade:{configuration["grade"]}");  //grade:mygrade

另外，需要註意，如果用dotnet命令來執行CommandLineSample.dll，那麼“應用程式參數”需要直接跟在命令的後面，如：
- 另外如果AddInMemoryCollection和AddCommandLine同時使用，那麼需要將AddCommandLine最後調用，否則一旦被覆蓋了，再用dotnet來調用，會沒有效果。

 dotnet   CommandLineSample.dll   name=111 class=222  grade="my grade"

使用JSON文件

在項目根目錄創建“jsconfig1.json”，同時修改該文件的屬性：
- 複製到輸出目錄：始終複製
- 生成操作：內容

JSON文件內容：

{
      "Class": "Class A",
      "PersonInfo": {
            "name": "my name",
            "age": "12"
      },
      "Hobbies": [
            {
                  "Type": "Family",
                  "HobbyName": "Piano"
            },
            {
                  "Type": "Personal",
                  "HobbyName": "Singing"
            }
      ]
}

代碼：

static void Main(string[] args)
{
    var builder = new ConfigurationBuilder()
        .AddJsonFile("jsconfig1.json");

    var configuration = builder.Build();

    Console.WriteLine($"name:{configuration["PersonInfo:name"]}");
    Console.WriteLine($"class:{configuration["class"]}");
    Console.WriteLine($"age:{configuration["PersonInfo:age"]}");
    //註意下調用參數時的格式："{參數Key}:{數組索引}:{子項參數Key}"
    Console.WriteLine($"FamilyHobby:{configuration["Hobbies:0:HobbyName"]}");
    Console.WriteLine($"PersonalHobby:{configuration["Hobbies:1:HobbyName"]}");

    Console.Read();
}

註冊配置文件中的某一個段到一個class模型中

引用上面的json：

{
      "Class": "Class A",
      "PersonInfo": {
            "name": "my name",
            "age": "12"
      },
      "Hobbies": [
            {
                  "Type": "Family",
                  "HobbyName": "Piano"
            },
            {
                  "Type": "Personal",
                  "HobbyName": "Singing"
            }
      ]
}

如何在註冊的時候希望將PersonInfo這個section單獨註入到 PersonInfo.cs類中？（以mvc為例）

PersonInfo.cs

public class PersonInfo
{
    public string Name {get;set;}
    public int Age{get;set;}
}

Startup.cs


        public void ConfigureServices(IServiceCollection services)
        {
            services.Configure<CookiePolicyOptions>(options =>
            {
                options.CheckConsentNeeded = context => true;
                options.MinimumSameSitePolicy = SameSiteMode.None;
            });
            // 依賴註入
            services.Configure<PersonInfo>(Configuration.GetSection("PersonInfo"));

            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
        }

在controller中使用：

    public class TestController : Controller
    {
        private readonly PersonInfo   _personInfo;
        public TestController(IOptions<PersonInfo> personInfo)
        {
            _personInfo = _personInfo.Value;
        }

        public IActionResult Index()
        {
            return View("Index", _personInfo.Name);
        }
    }

在 startup.cs中使用

//jwt           
services.Configure<JwtSettings>(Configuration.GetSection("JwtSettings"));

var jwtSettings = new JwtSettings();
Configuration.Bind("JwtSettings", jwtSettings);
services.AddSanbenTechJwtService(jwtSettings.Issuer, jwtSettings.Audience);

示例：在單元測試中使用配置文件

首先確保配置文件的屬性：

nuget安裝、引入必要的庫：

Microsoft.Extensions.Configuration
Microsoft.Extensions.Configuration.Binder
Microsoft.Extensions.Configuration.Json

在構造函數中使用配置文件：

        public UnitTest1()
        {
            var builder = new ConfigurationBuilder()
                .AddJsonFile("appsettings.json");
            var configuration = builder.Build();
            var settings = configuration.GetSection("RedisSettings").Get<RedisSettings>();
            _mock.Setup(p => p.Value).Returns(settings);
        }

一個官方例子

https://docs.microsoft.com/zh-cn/aspnet/core/security/app-secrets?view=aspnetcore-2.2&tabs=windows

{
  "Movies": {
    "ServiceApiKey": "12345",
    "ConnectionString": "Server=(localdb)\\mssqllocaldb;Database=Movie-1;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

配置模型：

public class MovieSettings
{
    public string ConnectionString { get; set; }

    public string ServiceApiKey { get; set; }
}

//使用
var moviesConfig = Configuration.GetSection("Movies").Get<MovieSettings>();
_moviesApiKey = moviesConfig.ServiceApiKey;

FAQ

在使用AddJsonFile的時候，被添加的json文件需要在項目所處根目錄內，否則不會載入（路徑預設是到項目文件夾，而非bin目錄下）。打包發佈後會自動從發佈文件夾找對應的配置文件
- 這裡主要是為了應對新建了一個項目A，然後在這個項目A中添加了一個配置文件config.json，項目B引用這個項目A後，雖然最終編譯之後會在bin文件夾內自動生成config.json，但是在調試模式下，預設的路徑是在項目路徑，而非bin下的文件夾路徑，這會導致config.json在開發模式下（調試時）不會被載入。
  - 可以手動將改config.json文件複製一份到項目B根目錄內。
  - 如果是用nuget發佈項目A後，項目B再從nuget安裝項目A，則不會有此問題。

在.NET CORE中使用配置文件：對 ConfigurationBuilder 的使用說明