.NetCore獲取Json和Xml格式的配置信息

更新時間：2017年09月18日 11:22:38 作者：神牛步行3

本篇將和大家分享的是如何獲取Json和Xml格式的配置信息，主要介紹的是Configuration擴展方法的使用，對.netcore 獲取json和xml格式的配置信息的相關(guān)知識，感興趣的朋友一起看看吧

本篇將和大家分享的是：如何獲取Json和Xml格式的配置信息，主要介紹的是Configuration擴展方法的使用，因為netcore的web應(yīng)用在Startup中已經(jīng)默認嵌入appsettings.json文件的配置信息，故而我把測試點放在在了netcore的控制臺應(yīng)用上；控制臺上使用配置文件也是常用的事情，并且官網(wǎng)實例主要講解的是json格式，對xml格式直接帶過了，因此有了本篇的分享，希望能給你好的幫助；

獲取Json配置信息
獲取Xml配置信息
獲取xml節(jié)點屬性值

配置文件能否不和應(yīng)用放在一起呢？答案是肯定的

對于netcore的netstandard擴展來說其自帶了配置文件信息操作類，因為core的Web應(yīng)用和控制臺應(yīng)用都是統(tǒng)一的，因此下面講解測試用例在控制臺應(yīng)用演示的，但是也可用于Web應(yīng)用；

首先，咋們需要在控制臺應(yīng)用中引用如下nuget包（我這里測試基于2.0）：

 Install-Package Microsoft.Extensions.Configuration -Version 2.0.0 
 Install-Package Microsoft.Extensions.Configuration.Abstractions -Version 2.0.0

獲取Json配置信息

要獲取json配置我們除了上面兩個引用外，還需要引用：

 Install-Package Microsoft.Extensions.Configuration.Json -Version 2.0.0

這是json配置的基礎(chǔ)引用，我們在控制臺應(yīng)用中創(chuàng)建appsettings.json文件，并定義如下json配置文件信息：

{
 "MyConfig": {
 "UserName": "神牛步行3",
 "userPwd": "666666",
 "GaoDeApi": {
  "UserName": "神牛步行1",
  "userPwd": "111111"
 },
 "BaiDuApi":{
  "userName": "神牛步行2",
  "userPwd": "222222"
 }
 }
}

然后只需要如下代碼，即可獲取到該文件信息：

var configBasePath = Directory.GetCurrentDirectory(); //configBasePath = @"D:\D\TTest";
sbLog.Append($"配置文件所在目錄：{configBasePath}\n");
var builder = new ConfigurationBuilder().
     SetBasePath(configBasePath).
     AddJsonFile("appsettings.json");
var config = builder.Build();
sbLog.Append($"MyConfig:UserName節(jié)點的值：{config.GetSection("MyConfig:UserName").Value}");

對于已經(jīng)有core開發(fā)經(jīng)驗的朋友而言，上面直接能看懂，不過為了完善的講解這里還是需要簡單說下的：

ConfigurationBuilder實例過后需要通過SetBasePath方法設(shè)置配置文件基礎(chǔ)路徑，再通過AddJsonFile擴展方法指定讀取的文件名稱；這些步驟執(zhí)行返回的都是IConfigurationBuilder接口，最后還需要Build方法執(zhí)行加載配置信息，這個builder有點類似于start的意思；來看看效果圖：

很顯然這里獲取到了配置文件中的MyConfig:UserName節(jié)點的值，這里通過 IConfigurationSection GetSection(string key); 函數(shù)獲取配置節(jié)點，配置節(jié)點層級關(guān)系通過“:”鏈接，因此這里就有了key=MyConfig:UserName；

為了程序的美觀性和多使用性，這里吧獲取json文件的封裝為如下方法：

/// <summary>
/// json配置文件讀取
/// </summary>
/// <param name="configFileName"></param>
/// <param name="basePath"></param>
/// <returns></returns>
public static IConfigurationRoot GetJsonConfig(
   string configFileName = "appsettings.json",
   string basePath = "")
{
  basePath = string.IsNullOrWhiteSpace(basePath) ? Directory.GetCurrentDirectory() : basePath;
  var builder = new ConfigurationBuilder().
    SetBasePath(basePath).
    AddJsonFile(configFileName);
  return builder.Build();
}

對了這里注意下AddJsonFile方法是通過開節(jié)引用的 Microsoft.Extensions.Configuration.Json 擴展的；由于IConfiguration不光用GetSection函數(shù)，她也能根據(jù) this[string key] 方式獲取節(jié)點，下面是分別獲取高德地圖和百度地圖配置節(jié)點信息的代碼和效果圖：

var configJson = GetJsonConfig();
sbLog.Append($"json配置-MyConfg節(jié)點的值：\n");
sbLog.Append($"高德-UserName：{configJson.GetSection("MyConfig:GaoDeApi:UserName").Value}\n");
sbLog.Append($"百度-userName：{configJson["MyConfig:BaiDuApi:UserName"]}\n\r\n");

注意：節(jié)點不區(qū)分大小寫，多級節(jié)點使用‘:'獲取；

獲取Xml配置信息

xml配置文件也是我們常見的，對已擴展的IConfigurationBuilder來說，我們同樣也有類似于json那樣擴展的方法，首先需要引用如下包：

 Install-Package Microsoft.Extensions.Configuration.Xml -Version 2.0.0

然后幾乎和json同樣的代碼獲取xml配置文件：

/// <summary>
/// xml配置文件讀取
/// </summary>
/// <param name="configFileName"></param>
/// <param name="basePath"></param>
/// <returns></returns>
public static IConfigurationRoot GetXmlConfig(
   string configFileName = "appsettings.xml",
   string basePath = "")
{
   basePath = string.IsNullOrWhiteSpace(basePath) ? Directory.GetCurrentDirectory() : basePath;
   var builder = new ConfigurationBuilder().
    //SetBasePath(basePath).
    AddXmlFile(b =>
    {
     b.Path = configFileName;
     b.FileProvider = new PhysicalFileProvider(basePath);
    });
   return builder.Build();
}

區(qū)別在于擴展IConfigurationBuilder的AddXmlFile方法，本次示例為了多樣化使用了 public static IConfigurationBuilder AddXmlFile(this IConfigurationBuilder builder, Action<XmlConfigurationSource> configureSource) 來傳遞配置文件名稱和基礎(chǔ)路徑；

下面來新建并初始化appsettings.xml配置文件信息：

<MyConfig>
 <GaoDeApi>
 <UserName des="高德的賬號">神牛步行1</UserName>
 <userPwd>111111</userPwd>
 </GaoDeApi>
 <BaiDuApi>
 <userName des="百度的賬號">神牛步行2</userName>
 <userPwd>222222</userPwd>
 </BaiDuApi>
</MyConfig>

再來看看調(diào)用獲取配置節(jié)點的部分代碼：

var configXml = GetXmlConfig();
sbLog.Append($"xml配置-MyConfg節(jié)點的值：\n");
sbLog.Append($"高德-UserName：{configXml.GetSection("GaoDeApi:UserName").Value}\n");
sbLog.Append($"百度-userName：{configXml["BaiDuApi:UserName"]}\n\r\n");

能夠看出xml和json讀取配置節(jié)點的方式一樣“:”表示層級關(guān)系，但是特別注意點在于xml不需要最外層跟節(jié)點，如這里的：GaoDeApi:UserName，如果按照json方式的話這里的key應(yīng)該是這樣：MyConfig:GaoDeApi:UserName，這里就是兩種的另外一種區(qū)別；如圖：

不出以外json和xml配置信息都能獲取到了；

獲取xml節(jié)點屬性值

通常xml配置文件節(jié)點還有屬性(attribute)，如上面的xml節(jié)點： <UserName des="高德的賬號">神牛步行1</UserName> ，這個des=""就是屬性，我們要怎么才能獲取這個值呢；這里其實同樣還是通過':'來關(guān)聯(lián)的，如下代碼獲取屬性節(jié)點des的值：

sbLog.Append($"高德-UserName-des：{configXml.GetSection("GaoDeApi:UserName:des").Value}\n");
sbLog.Append($"百度-userName-des：{configXml["BaiDuApi:UserName:des"]}\n\r\n");

xml屬性節(jié)點名稱不能是name，不然是無法讀取成功的；如這里的des改成name名稱的話，無法正常獲取信息，謹記于心；

配置文件能否不和應(yīng)用放在一起呢？答案是肯定的

有部分朋友會提出一個問題：配置文件能否不和應(yīng)用放在一起呢？答案是肯定的，我們只需把Directory.GetCurrentDirectory()（獲取當前應(yīng)用所在磁盤目錄）替換成配置文件所在的基礎(chǔ)目錄就行了，如我這里的： configBasePath = @"D:\D\TTest";

下面是本次實例的整個測試用例代碼：

using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.Json;
using Microsoft.Extensions.FileProviders;
using System;
using System.Diagnostics;
using System.IO;
using System.Text;
namespace MyService
{
 class Program
 {
  static void Main(string[] args)
  {
   Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);
   Console.OutputEncoding = Encoding.GetEncoding("GB2312");
   var sbLog = new StringBuilder(string.Empty);
   var configBasePath = Directory.GetCurrentDirectory(); //configBasePath = @"D:\D\TTest";
   sbLog.Append($"配置文件所在目錄：{configBasePath}\n");
   var builder = new ConfigurationBuilder().
    SetBasePath(configBasePath).
    AddJsonFile("appsettings.json");
   var config = builder.Build();
   sbLog.Append($"MyConfig:UserName節(jié)點的值：{config.GetSection("MyConfig:UserName").Value}\n\r\n");
   var configJson = GetJsonConfig();
   sbLog.Append($"json配置-MyConfg節(jié)點的值：\n");
   sbLog.Append($"高德-UserName：{configJson.GetSection("MyConfig:GaoDeApi:UserName").Value}\n");
   sbLog.Append($"百度-userName：{configJson["MyConfig:BaiDuApi:UserName"]}\n\r\n");
   var configXml = GetXmlConfig();
   sbLog.Append($"xml配置-MyConfg節(jié)點的值：\n");
   sbLog.Append($"高德-UserName：{configXml.GetSection("GaoDeApi:UserName").Value}\n");
   sbLog.Append($"百度-userName：{configXml["BaiDuApi:UserName"]}\n\r\n");
   sbLog.Append($"高德-UserName-des：{configXml.GetSection("GaoDeApi:UserName:des").Value}\n");
   sbLog.Append($"百度-userName-des：{configXml["BaiDuApi:UserName:des"]}\n\r\n");
   Console.WriteLine(sbLog);
   Console.ReadLine();
  }
  /// <summary>
  /// json配置文件讀取
  /// </summary>
  /// <param name="configFileName"></param>
  /// <param name="basePath"></param>
  /// <returns></returns>
  public static IConfigurationRoot GetJsonConfig(
   string configFileName = "appsettings.json",
   string basePath = "")
  {
   basePath = string.IsNullOrWhiteSpace(basePath) ? Directory.GetCurrentDirectory() : basePath;
   var builder = new ConfigurationBuilder().
    SetBasePath(basePath).
    AddJsonFile(configFileName);
   return builder.Build();
  }
  /// <summary>
  /// xml配置文件讀取
  /// </summary>
  /// <param name="configFileName"></param>
  /// <param name="basePath"></param>
  /// <returns></returns>
  public static IConfigurationRoot GetXmlConfig(
   string configFileName = "appsettings.xml",
   string basePath = "")
  {
   basePath = string.IsNullOrWhiteSpace(basePath) ? Directory.GetCurrentDirectory() : basePath;
   var builder = new ConfigurationBuilder().
    //SetBasePath(basePath).
    AddXmlFile(b =>
    {
     b.Path = configFileName;
     b.FileProvider = new PhysicalFileProvider(basePath);
    });
   return builder.Build();
  }
 }
}

總結(jié)

以上所述是小編給大家介紹的.NetCore獲取Json和Xml格式的配置信息，希望對大家有所幫助，如果大家有任何疑問請給我留言，小編會及時回復大家的。在此也非常感謝大家對腳本之家網(wǎng)站的支持！

您可能感興趣的文章: