来源https://docs.asp.net/en/latest/fundamentals/configuration.html

ASP.NET Core 1.0支持不同的配置选项。应用配置数据可以是来自Json,XML,INI等格式,这些格式都是内建支持。当然配置数据也可以来自环境变量。你也可以写自己的环境provider

你可以从Github下载样例代码

获取和设置环境配置##

ASP.NET Core 1.0的环境系统是经过重新设计的,不像之前的是依赖于System.Configuration和类似web.config之类的xml文件的。新的配置模型中,配置可以从不同的provider中获取,并且这些设置是支持streamlined键值对获取的。使用新的options pattern,应用和框架可以获取配置。

为了处理配置问题,推荐的做法是在Startup类中,实例化一个Configuration对象,然后使用options pattern来接入不同的配置。

简单来说,Configuration是一系列配置provider的集合,提供读取和写入键对值的功能。为了Configuration能正常工作,至少要配置一个provider。下例展示了怎样测试作为键对值存储的Configuration。

// assumes using Microsoft.Framework.ConfigurationModel is specified
var builder = new ConfigurationBuilder();
builder.Add(new MemoryConfigurationProvider());
var config = builder.Build();
config.Set("somekey", "somevalue"); // do some other work string setting2 = config["somekey"]; // also returns "somevalue"

Note:你必须设置至少一个provider

通常情况下,配置数据是分层结构存储的,尤其使用外部文件时,如Json,XML,INI等。在这种情况下,配置数据可以通过分隔符:来获取。考虑如下配置文件

{
"Data": {
"DefaultConnection": {
"ConnectionString": "Server=(localdb)\\mssqllocaldb;Database=aspnet5-WebApplication1-8479b9ce-7b8f-4402-9616-0843bc642f09;Trusted_Connection=True;MultipleActiveResultSets=true"
}
},
"Logging": {
"IncludeScopes": false,
"LogLevel": {
"Default": "Verbose",
"System": "Information",
"Microsoft": "Information"
}
}
}

应用使用配置文件来配置连接字符串,获取该值可以使用这样的键Data:DefaultConnection:ConnectionString。

使用options pattern可以解耦应用所需的配置和获取指定配置的机制。为了使用options pattern,你需要创建自己的设置类(或许是几个不同的类,对应几个不同的内聚的设置组),这样你可以使用options 服务将他们注入你的应用。然后你可以使用configuration或者任何你选择的机制来指定settings。

Note: 你可以将Configuration实例作为服务存储起来,但是这会不必要地将你的应用和单一配置系统以及特定的配置keys耦合起来。你应该使用Options pattern来避免该问题。

使用内建的provider##

配置框架有内置的对JSON,XML和INI配置文件的支持,同样的支持内存中的配置(直接在代码中设置值),以及从环境配置和命令行参数中取得配置。开发者并不局限于一种provider。事实上,若干个provider可以一起使用,这样的话默认的配置会被其他provider提供的配置所覆盖(如果存在的话)。

通过扩展方法,可以实现对其他配置文件provider的支持。这些方法由ConfigurationBuilder单独调用或者作为fluent API调用,如下

var config = builder.Build();

builder.AddEntityFramework(options => options.UseSqlServer(config["Data:DefaultConnection:ConnectionString"]));
config = builder.Build();

configuration providers的顺序是很重要的,因为这决定了如果配置在多个位置的话,哪个配置将会被应用。如上例,如果同样的值存在appsettings.json和环境变量中,环境变量中的配置将会被应用。如果配置存在多个位置,最后一个provider指定的值将会覆盖之前的值。ASP.NET团队推荐将环境变量的配置放在最后,这样本地环境变量将会覆盖任何被部署的配置文件。

Note: 在shell中通过环境变量覆盖嵌套的值,并不支持“:”,而是使用“__”(double undercore)。

使用基于环境的配置文件是很有用的,如下

public Startup(IHostingEnvironment env)
{
// Set up configuration providers.
var builder = new ConfigurationBuilder()
.AddJsonFile("appsettings.json")
.AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true); if (env.IsDevelopment())
{
// For more details on using the user secret store see http://go.microsoft.com/fwlink/?LinkID=532709
builder.AddUserSecrets();
} builder.AddEnvironmentVariables();
Configuration = builder.Build();
}

IHostingEnvironment 服务用来获取当前环境,如果在Development环境,第6行代码将会查找appsettings.Development.json文件,如果存在的话,并使用其中的配置项来重写其他的值,详见Working with Multiple Environments

Warning:你绝对不应存储密码或其他敏感信息在provider代码中或者配置文件中。你也不应该在开发和测试环境中使用生产环境密码。事实上,这些信息应该在项目树之外指定,这样能避免偶然情况下将其提交到provider仓储中。详见Multiple Environments和管理Safe Storage of Application Secrets

一种可以利用Configuration优先级顺序的方式是使用默认值,默认值可被覆盖。在如下控制台程序中,username的默认值是在MemoryConfigurationProvider中指定的,如果命令行参数中提供了username的值,那么该值会被重写。你可以查看多个Configuration provider在不同阶段时,程序的输出。

using System;
using System.Linq;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.Memory; namespace ConfigConsole
{
public class Program
{
public void Main(string[] args)
{
var builder = new ConfigurationBuilder();
Console.WriteLine("Initial Config Providers: " + builder.Providers.Count()); var defaultSettings = new MemoryConfigurationProvider();
defaultSettings.Set("username", "Guest");
builder.Add(defaultSettings);
Console.WriteLine("Added Memory Provider. Providers: " + builder.Providers.Count()); builder.AddCommandLine(args);
Console.WriteLine("Added Command Line Provider. Providers: " + builder.Providers.Count()); var config = builder.Build();
string username = config["username"]; Console.WriteLine($"Hello, {username}!");
}
}
}

但程序运行时,除非命令行参数覆盖,程序将会输出默认值

使用Options和配置对象##

使用Options你可以轻易的将任何POCO类转换成设置类。推荐的做法是,在应用中对应某种feature,创建一个良好解耦的配置对象。遵循接口隔离原则(ISP)的同时也满足关注点分离(不同部分的配置是分开管理的,因此减少相互不利影响)。

如下一个简单的MyOptions的例子

public class MyOptions
{
public string Option1 { get; set; }
public int Option2 { get; set; }
}

通过IOptions服务可以将Options注入应用。例如,MVC controller利用IOptions来获取填充index视图所需的配置。

public class HomeController : Controller
{
public HomeController(IOptions<MyOptions> optionsAccessor)
{
Options = optionsAccessor.Value;
} MyOptions Options { get; } // GET: /<controller>/
public IActionResult Index()
{
return View(Options);
}
}

更多详见依赖注入

为了启动IOpitons服务,你需要在Startup类中ConfigureServices中调用扩展方法AddOptions()。

public void ConfigureServices(IServiceCollection services)
{
// Setup options with DI
services.AddOptions();
}

Index视图显示如下



通过扩展方法Configure来配置选项。可以通过使用delegate或者绑定options到Configuration。

public void ConfigureServices(IServiceCollection services)
{
// Setup options with DI
services.AddOptions(); // Configure MyOptions using config
services.Configure<MyOptions>(Configuration); // Configure MyOptions using code
services.Configure<MyOptions>(myOptions =>
{
myOptions.Option1 = "value1_from_action";
}); // Add framework services.
services.AddMvc();

当绑定options到configuration时,配置类中的属性绑定的key具有property:subproperty:...的形式。例如,MyOptions.Option1所绑定key就是Option1,它是从appsettings.json的option1键中读取的。注意配置键是大小写不敏感的。

每次调用Configure都添加一个IConfigurations到服务容器中,然后有IOptions来将配置选项提供给应用或框架。如果你想使用别的方式直接配置选项(如从数据库读取设置),你可以直接使用ConfigureOptions<TOptions扩展方法来specify一个你自定义的IConfigureOptions的服务。

对于同样的配置选项,你可以使用多个IConfiguration服务,他们会按顺序起作用。在上例中Option1和Option2值都在appsettings.json中指定,但是option1的值会被configuration delegate所覆盖。

写自定义provider##

除了使用内建的configuration provider,你也可以编写自己的。你只需要继承ConfigurationProvider类,然后populate the Data property with the settings from your configuration provider。

例子:EF设置###

你可能希望存储一些应用设置选项到数据库中,使用EF来获取它们。你可以有很多方式存储设置,在本例中,我们创建一个简单的configuration provider,来使用EF读取数据库中的name-value对。

首先我们定义ConfigurationValue,来存储数据到数据库中。

public class ConfigurationValue
{
public string Id { get; set; }
public string Value { get; set; }
}

我们还需要一个ConfigurationContext来使用EF存储或获取配置选项值。

public class ConfigurationContext : DbContext
{
public ConfigurationContext(DbContextOptions options) : base(options)
{
} public DbSet<ConfigurationValue> Values { get; set; } }

然后创建configuration provider。配置数据通过重写Load方法来载入,它从数据库中读取所有的配置数据。为了演示的目的,如果数据库没有存在和populate,configuration provider会首先创建并初始化数据库。

public class EntityFrameworkConfigurationProvider : ConfigurationProvider
{
public EntityFrameworkConfigurationProvider(Action<DbContextOptionsBuilder> optionsAction)
{
OptionsAction = optionsAction;
} Action<DbContextOptionsBuilder> OptionsAction { get; } public override void Load()
{
var builder = new DbContextOptionsBuilder<ConfigurationContext>();
OptionsAction(builder); using (var dbContext = new ConfigurationContext(builder.Options))
{
dbContext.Database.EnsureCreated();
Data = !dbContext.Values.Any()
? CreateAndSaveDefaultValues(dbContext)
: dbContext.Values.ToDictionary(c => c.Id, c => c.Value);
}
} private IDictionary<string, string> CreateAndSaveDefaultValues(ConfigurationContext dbContext)
{
var configValues = new Dictionary<string, string>
{
{ "key1", "value_from_ef_1" },
{ "key2", "value_from_ef_2" }
};
dbContext.Values.AddRange(configValues
.Select(kvp => new ConfigurationValue() { Id = kvp.Key, Value = kvp.Value })
.ToArray());
dbContext.SaveChanges();
return configValues;
}
}

同时,我们还需要添加AddEntityFramework扩展方法来添加configuration provider

public static class EntityFrameworkExtensions
{
public static IConfigurationBuilder AddEntityFramework(this IConfigurationBuilder builder, Action<DbContextOptionsBuilder> setup)
{
return builder.Add(new EntityFrameworkConfigurationProvider(setup));
}
}

在下例中,你可以看到如何在应用中使用自定义configuration provider。创建ConfigurationBuilder 来setup你的configuration provders。添加EntityFrameworkConfigurationProvider来指定data provider和连接字符串。怎样配置连接字符串呢?当然是使用配置,添加appsettings.json文件作为configuration provider来启动EntityFrameworkConfigurationProvider。通过复用ConfigurationBuilder,数据中任何配置数据都能够重写appsettings.json中数据。

public class Program
{
public static void Main(string[] args)
{
var builder = new ConfigurationBuilder();
builder.AddJsonFile("appsettings.json");
builder.AddEnvironmentVariables();
var config = builder.Build(); builder.AddEntityFramework(options => options.UseSqlServer(config["Data:DefaultConnection:ConnectionString"]));
config = builder.Build(); Console.WriteLine("key1={0}", config["key1"]);
Console.WriteLine("key2={0}", config["key2"]);
Console.WriteLine("key3={0}", config["key3"]); }
}

运行程序,可以看到如下结果

总结##

ASP.NET Core 1.0提供很大灵活性的配置模型,可以支持不同文件类型配置,以及命令行,内存和环境变量等配置。他可以与options无缝连接,所以你可以注入强类型的配置到应用或框架中。同时你也可以创建自己的configuration provider,来和内嵌的provider配合,或者取代它们。

ASP.NET Core 1.0 基础之配置的更多相关文章

  1. ASP.NET Core 1.0 基础与应用启动

    .NET Core http://dotnet.github.io/[https://github.com/dotnet/coreclr] ASP.NET Core 1.0 https://get.a ...

  2. ASP.NET Core 1.0基础之依赖注入

      来源https://docs.asp.net/en/latest/fundamentals/dependency-injection.html ASP.NET Core 1.0在设计上原生就支持和 ...

  3. ASP.NET Core 1.0基础之日志

    过年出去玩了一圈,回来继续翻译.前两天偷懒没有翻译,只是转了两篇C# 7计划中的新features,大家还是很支持的.现在继续完善这个系列. 来源https://docs.asp.net/en/lat ...

  4. ASP.NET Core 1.0基础之诊断

    来源https://docs.asp.net/en/latest/fundamentals/diagnostics.html ASP.NET Core 1.0包含了一些新的特性来辅助诊断问题.可以在S ...

  5. asp.net core 2.0中的配置(1)---Configuration

    配置就是一个装配数据字典的过程,一个字典也就是一个键值对,所以从配置就是键值对. 在asp.net core中关于配置是由四个基本的类型来支撑的,是①IConfigurationSource②ICon ...

  6. ASP.NET Core 1.0基础之应用启动

    来源https://docs.asp.net/en/latest/fundamentals/startup.html ASP.NET 5 使得应用对每个http请求有完整的控制权.Startup类是程 ...

  7. ASP.NET Core 1.0基础之静态文件处理

    来源 这些HTML , CSS files, image files, 和JavaScript这些静态文件,是ASP.NET能够直接响应给客户端的.本文详述下ASP.NET和静态文件的关系. Serv ...

  8. ASP.NET Core 2.0 使用支付宝PC网站支付

    前言 最近在使用ASP.NET Core来进行开发,刚好有个接入支付宝支付的需求,百度了一下没找到相关的资料,看了官方的SDK以及Demo都还是.NET Framework的,所以就先根据官方SDK的 ...

  9. ASP.NET Core 2.0 使用支付宝PC网站支付实现代码(转)

    最近在使用ASP.NET Core来进行开发,刚好有个接入支付宝支付的需求,百度了一下没找到相关的资料,看了官方的SDK以及Demo都还是.NET Framework的,所以就先根据官方SDK的源码, ...

随机推荐

  1. jq用户评论点击回复简单代码。

    类似这种镶套回复评论: <div> <ul> <!--一条评论 begin--> <li> <div class="user-colum ...

  2. MYSQL-----控制流程函数(case when...then..else..end)

    MySQL有一些内置的控制流程函数,可以在SQL语句中使用这些函数来更加准确和直接的结果. 第一种语法: case when [value] then result ................. ...

  3. Canvas进阶——制作小游戏【贪吃蛇】

    今天呢,主要和小伙伴们分享一下一个贪吃蛇游戏从构思到实现的过程~因为我不是很喜欢直接PO代码,所以只copy代码的童鞋们请出门左转不谢. 按理说canvas与其应用是老生常谈了,可我在准备阶段却搜索不 ...

  4. ELK系列--问题汇总(二)

    1.Kibana4 dashboard无法保存拖动的visualization位置 原因: 程序bug,json部分未能及时保存拖动的情况 解决方法: 手动在设置中,手动编辑dashboard的jso ...

  5. cordova编译crosswalk-webview插件报错的处理办法

    一直用得好好的.今天编译cordova失败了.报错如下: :processArmv7DebugManifest :processArmv7DebugResourcesERROR: In FontFam ...

  6. Mysql 主键约束PrimaryKey

    Mysql 主键约束Primary Key 今天来简单的讲一下主键约束. 假如有一张学生信息表,里面记录了学生的学号 ,姓名,成绩等,那么,会不会有两个学号相同的学生,答案肯定是否定的,如果有的话也只 ...

  7. HDU 5707 Combine String(动态规划)

    题目链接:http://acm.hdu.edu.cn/showproblem.php?pid=5707 题意: 给你三个字符串 S1, S2, S3, 让你判断 S3 是否恰好由字符串 S1 和 S2 ...

  8. Python之路【第三篇】:文件操作

    一.文件操作步骤 打开文件,得到文件句柄并赋值给一个变量 通过句柄对文件进行操作 关闭文件 歌名:<大火> 演唱:李佳薇 作词:姚若龙 作曲:马奕强 歌词: 有座巨大的停了的时钟 倾倒在赶 ...

  9. GDB 调试工具高级用法

    解决core核心文件转出问题 ulimit -c #查看core文件的生成开关,若为0则关闭 ulimit -c unlimited #打开开关,只在当前shell生效 sudo sh -c 'ech ...

  10. Arduino可穿戴教程之第一个程序——连接硬件选择板子(二)

    Arduino可穿戴教程之第一个程序——连接硬件选择板子(二) 2.4.2  连接硬件 在选择好示例程序后就可以将LilyPad通过LilyPad编程器连接到电脑了. 2.4.3  选择板子 如果你了 ...