快捷導(dǎo)航

.NET?6全新配置對(duì)象ConfigurationManager介紹

更新時(shí)間：2021年11月23日 16:21:34 作者：初久的私房菜

這篇文章介紹了.NET?6全新配置對(duì)象ConfigurationManager，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

介紹

本節(jié)為大家?guī)?lái).NET 6新增的ConfigurationManager,很多人好奇為啥要講這個(gè)，讀取加載配置信息都隨手就來(lái)了，我們往下看一下。

翻譯：這添加了 ASP.NET Core 的新 WebApplcation 和 WebApplicationBuilder已經(jīng)使用的類(lèi)型，允許從配置（例如appsettings.json和DOTNET_/ASPNETCORE_環(huán)境變量）中讀取，同時(shí)仍然能夠添加新的配置源，而無(wú)需顯式重建配置。每次通過(guò)IConfigurationBuilder界面添加源時(shí)IConfiguration，都會(huì)立即自動(dòng)更新。

回顧歷史

我們?cè)谑褂?code>.NET 5開(kāi)發(fā)的時(shí)候，采用IConfigurationBuilder添加配置源。調(diào)用Build()構(gòu)建器讀取每個(gè)配置源，并構(gòu)建最終配置IConfigurationRoot。

private static IConfigurationRoot BuildConfiguration()
        {
            var builder = new ConfigurationBuilder()
                .SetBasePath(Path.Combine(Directory.GetCurrentDirectory(), "../MyCompanyName.MyProjectName.DbMigrator/"))
                .AddJsonFile("appsettings.json", optional: false);

            return builder.Build();
        }

當(dāng)然我們正常系統(tǒng)開(kāi)發(fā)基本上不會(huì)自己去調(diào)用ConfigurationBuilder或者調(diào)用Build(),這都在.Net Core底部給我們完成了。

那么這個(gè)類(lèi)型推出的意義是什么呢？

舉個(gè)栗子Use Application ID and X.509 certificate for non-Azure-hosted apps,這是微軟官方給出的案例，我來(lái)說(shuō)明一下，配置 Azure Key Vault 提供程序需要一個(gè)配置值，那么我是先有雞還是先有蛋呢——在構(gòu)建配置之前無(wú)法添加配置源！。

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureAppConfiguration((context, config) =>
        {
            if (context.HostingEnvironment.IsProduction())
            {
                var builtConfig = config.Build();

                using var store = new X509Store(StoreLocation.CurrentUser);
                store.Open(OpenFlags.ReadOnly);
                var certs = store.Certificates.Find(
                    X509FindType.FindByThumbprint,
                    builtConfig["AzureADCertThumbprint"], false);

                config.AddAzureKeyVault(new Uri($"https://{builtConfig["KeyVaultName"]}.vault.azure.net/"),
                                        new ClientCertificateCredential(builtConfig["AzureADDirectoryId"], builtConfig["AzureADApplicationId"], certs.OfType<X509Certificate2>().Single()),
                                        new KeyVaultSecretManager());

                store.Close();
            }
        })
        .ConfigureWebHostDefaults(webBuilder => webBuilder.UseStartup<Startup>());

我們的步驟是：

初始化配置
調(diào)用IConfigurationBuilder.Build()構(gòu)建配置
從IConfigurationRoot中檢索所需的配置值
添加配置源
框架調(diào)用Build()，生成最終應(yīng)用程序配置。

這里我們調(diào)用了Build()兩次，這會(huì)產(chǎn)生什么問(wèn)題呢？

ConfigurationBuilder.Build()每次調(diào)用會(huì)迭代所有源，加載提供者，并產(chǎn)生新的實(shí)例ConfigurationRoot.大家應(yīng)該都懂讀取文件所需的消耗吧。

新的實(shí)現(xiàn)

我們?cè)谑褂?code>ConfigurationManager時(shí)，當(dāng)IConfigurationSource添加一個(gè)AddJsonFile()調(diào)用，提供程序會(huì)立即加載，并更新配置。

 using var config = new ConfigurationManager();

    config.AddEnvironmentVariables(prefix: "MyCustomPrefix_");

    if (config["FileConfig"] == "enabled")
    {
        config.AddJsonFile("MyConfig.json", optional: true, reloadOnChange: true);
    } 

    string myValueFromJson = config["JsonConfigValue"];


public class ConfigurationManager
{

    private void AddSource(IConfigurationSource source)
    {
        lock (_providerLock)
        {
            IConfigurationProvider provider = source.Build(this);
            _providers.Add(provider);

            provider.Load();
            _changeTokenRegistrations.Add(ChangeToken.OnChange(() => provider.GetReloadToken(), () => RaiseChanged()));
        }

        RaiseChanged();
    }
}


private void ReloadSources()
{
    lock (_providerLock)
    {
        DisposeRegistrationsAndProvidersUnsynchronized();

        _changeTokenRegistrations.Clear();
        _providers.Clear();

        foreach (var source in _sources)
        {
            _providers.Add(source.Build(this));
        }

        foreach (var p in _providers)
        {
            p.Load();
            _changeTokenRegistrations.Add(ChangeToken.OnChange(() => p.GetReloadToken(), () => RaiseChanged()));
        }
    }

    RaiseChanged();
}

注意：ConfigurationManager因?yàn)闀?huì)任何源發(fā)生更改后必須刪除所有內(nèi)容并重新開(kāi)始，遍歷每個(gè)源，重新加載它們。如果你做了很多的配置源操縱的，那么如果使用ConfigurationManager會(huì)帶來(lái)相反的效果.

ConfigurationManager適用于配置部分建造和、完全構(gòu)建。