怎么在.NetCore中獲取Json與Xml格式的配置信息

這篇文章將為大家詳細講解有關怎么在.NetCore中獲取Json與Xml格式的配置信息，文章內容質量較高，因此小編分享給大家做個參考，希望大家閱讀完這篇文章后對相關知識有一定的了解。

首先，咋們需要在控制臺應用中引用如下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配置的基礎引用，我們在控制臺應用中創建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節點的值：{config.GetSection("MyConfig:UserName").Value}");

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

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

很顯然這里獲取到了配置文件中的MyConfig:UserName節點的值，這里通過 IConfigurationSection GetSection(string key); 函數獲取配置節點，配置節點層級關系通過“:”鏈接，因此這里就有了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方法是通過開節引用的 Microsoft.Extensions.Configuration.Json 擴展的；由于IConfiguration不光用GetSection函數，她也能根據 this[string key] 方式獲取節點，下面是分別獲取高德地圖和百度地圖配置節點信息的代碼和效果圖：

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

注意：節點不區分大小寫，多級節點使用‘:'獲取；

獲取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();
}

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

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

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

再來看看調用獲取配置節點的部分代碼：

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

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

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

獲取xml節點屬性值

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

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

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

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

有部分朋友會提出一個問題：配置文件能否不和應用放在一起呢？ 答案是肯定的，我們只需把Directory.GetCurrentDirectory()（獲取當前應用所在磁盤目錄）替換成配置文件所在的基礎目錄就行了，如我這里的： 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節點的值：{config.GetSection("MyConfig:UserName").Value}\n\r\n");
   var configJson = GetJsonConfig();
   sbLog.Append($"json配置-MyConfg節點的值：\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節點的值：\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();
  }
 }
}

關于怎么在.NetCore中獲取Json與Xml格式的配置信息就分享到這里了，希望以上內容可以對大家有一定的幫助，可以學到更多知識。如果覺得文章不錯，可以把它分享出去讓更多的人看到。