配置入門

在這個例子中,我們將描述當你構建一個新專案時會發生什麼。

首先,以下依賴項將新增到你的專案(當前 project.json 檔案):

"Microsoft.Extensions.Configuration.EnvironmentVariables": "1.0.0",
"Microsoft.Extensions.Configuration.Json": "1.0.0",

它還將在你的 Startup.cs 檔案中建立一個建構函式,該檔案將負責使用 ConfigurationBuilder 流暢的 api 構建配置:

  1. 它首先創造了一個新的 ConfigurationBuilder
  2. 然後它設定一個基本路徑,用於計算更多檔案的絕對路徑
  3. 它向配置構建器新增了一個可選的 appsettings.json 並監視它的更改
  4. 它新增了一個可選的環境相關的 appsettings.environementName.json 配置檔案
  5. 然後它新增了 environement 變數。
public Startup(IHostingEnvironment env)
{
    var builder = new ConfigurationBuilder()
        .SetBasePath(env.ContentRootPath)
        .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
        .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true)
        .AddEnvironmentVariables();

    Configuration = builder.Build();
}

如果在多個源中設定了相同的設定,則新增的最新源將獲勝並且將選擇其值。

然後可以使用索引器屬性來使用配置。冒號:字元用於路徑分隔符。

Configuration["AzureLogger:ConnectionString"]

這將在 AzureLogger 部分中查詢配置值 ConnectionString