Получение значения из appsettings.json в ядре .net


162

Не уверен, что мне здесь не хватает, но я не могу получить значения из моего appsettings.json в моем основном приложении .net. У меня есть appsettings.json как:

{
    "AppSettings": {
        "Version": "One"
    }
}

Запускать:

public class Startup
{
    private IConfigurationRoot _configuration;
    public Startup(IHostingEnvironment env)
    {
        _configuration = new ConfigurationBuilder()
    }
    public void ConfigureServices(IServiceCollection services)
    {
      //Here I setup to read appsettings        
      services.Configure<AppSettings>(_configuration.GetSection("AppSettings"));
    }
}

Модель:

public class AppSettings
{
    public string Version{ get; set; }
}

контроллер:

public class HomeController : Controller
{
    private readonly AppSettings _mySettings;

    public HomeController(IOptions<AppSettings> settings)
    {
        //This is always null
        _mySettings = settings.Value;
    }
}

_mySettingsвсегда ноль. Есть ли что-то, что мне здесь не хватает?


3
Пожалуйста, прочтите документацию о том, как использовать конфигурацию. Вы неправильно настроили конфигурацию в своем классе запуска.
совать

Спасибо за документацию. Это было полезно.
аман

это можно даже упростить, просто используя внедрение зависимости IConfiguration. Что объясняется здесь coding-issues.com/2018/10/…
Ranadheer Reddy

Ответы:


230

Программа и класс запуска

.NET Core 2.x

Вам не нужно нового IConfigurationв Startupконструкторе. Его реализация будет внедрена системой DI.

// Program.cs
public class Program
{
    public static void Main(string[] args)
    {
        BuildWebHost(args).Run();
    }

    public static IWebHost BuildWebHost(string[] args) =>
        WebHost.CreateDefaultBuilder(args)
            .UseStartup<Startup>()
            .Build();            
}

// Startup.cs
public class Startup
{
    public IHostingEnvironment HostingEnvironment { get; private set; }
    public IConfiguration Configuration { get; private set; }

    public Startup(IConfiguration configuration, IHostingEnvironment env)
    {
        this.HostingEnvironment = env;
        this.Configuration = configuration;
    }
}

.NET Core 1.x

Вы должны сказать, Startupчтобы загрузить файлы appsettings.

// Program.cs
public class Program
{
    public static void Main(string[] args)
    {
        var host = new WebHostBuilder()
            .UseKestrel()
            .UseContentRoot(Directory.GetCurrentDirectory())
            .UseIISIntegration()
            .UseStartup<Startup>()
            .UseApplicationInsights()
            .Build();

        host.Run();
    }
}

//Startup.cs
public class Startup
{
    public IConfigurationRoot Configuration { get; private set; }

    public Startup(IHostingEnvironment env)
    {
        var builder = new ConfigurationBuilder()
            .SetBasePath(env.ContentRootPath)
            .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
            .AddJsonFile($"appsettings.{env.EnvironmentName}.json", optional: true)
            .AddEnvironmentVariables();

        this.Configuration = builder.Build();
    }
    ...
}

Получение ценностей

Есть много способов получить значение, которое вы настраиваете в настройках приложения:

Допустим, ваша appsettings.jsonвнешность выглядит так:

{
    "ConnectionStrings": {
        ...
    },
    "AppIdentitySettings": {
        "User": {
            "RequireUniqueEmail": true
        },
        "Password": {
            "RequiredLength": 6,
            "RequireLowercase": true,
            "RequireUppercase": true,
            "RequireDigit": true,
            "RequireNonAlphanumeric": true
        },
        "Lockout": {
            "AllowedForNewUsers": true,
            "DefaultLockoutTimeSpanInMins": 30,
            "MaxFailedAccessAttempts": 5
        }
    },
    "Recaptcha": { 
        ...
    },
    ...
}

Простой способ

Вы можете вставить всю конфигурацию в конструктор вашего контроллера / класса (через IConfiguration) и получить желаемое значение с помощью указанного ключа:

public class AccountController : Controller
{
    private readonly IConfiguration _config;

    public AccountController(IConfiguration config)
    {
        _config = config;
    }

    [AllowAnonymous]
    public IActionResult ResetPassword(int userId, string code)
    {
        var vm = new ResetPasswordViewModel
        {
            PasswordRequiredLength = _config.GetValue<int>(
                "AppIdentitySettings:Password:RequiredLength"),
            RequireUppercase = _config.GetValue<bool>(
                "AppIdentitySettings:Password:RequireUppercase")
        };

        return View(vm);
    }
}

Варианты шаблона

ConfigurationBuilder.GetValue<T>Отлично работает , если вам нужно только одно или два значения из настроек приложения. Но если вы хотите получить несколько значений из настроек приложения или не хотите жестко кодировать эти ключевые строки в нескольких местах, может быть проще использовать шаблон параметров . Шаблон параметров использует классы для представления иерархии / структуры.

Чтобы использовать параметры шаблона:

  1. Определите классы для представления структуры
  2. Зарегистрируйте экземпляр конфигурации, с которым связываются эти классы
  3. Внедрить IOptions<T>в конструктор контроллера / класса, для которого вы хотите получить значения

1. Определите классы конфигурации для представления структуры

Вы можете определить классы со свойствами, которые должны точно соответствовать ключам в настройках вашего приложения. Имя класса не обязательно должно совпадать с именем раздела в настройках приложения:

public class AppIdentitySettings
{
    public UserSettings User { get; set; }
    public PasswordSettings Password { get; set; }
    public LockoutSettings Lockout { get; set; }
}

public class UserSettings
{
    public bool RequireUniqueEmail { get; set; }
}

public class PasswordSettings
{
    public int RequiredLength { get; set; }
    public bool RequireLowercase { get; set; }
    public bool RequireUppercase { get; set; }
    public bool RequireDigit { get; set; }
    public bool RequireNonAlphanumeric { get; set; }
}

public class LockoutSettings
{
    public bool AllowedForNewUsers { get; set; }
    public int DefaultLockoutTimeSpanInMins { get; set; }
    public int MaxFailedAccessAttempts { get; set; }
}

2. Зарегистрируйте экземпляр конфигурации

И тогда вам нужно зарегистрировать этот экземпляр конфигурации ConfigureServices()при запуске:

using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
...

namespace DL.SO.UI.Web
{
    public class Startup
    {
        ...
        public void ConfigureServices(IServiceCollection services)
        {
            ...
            var identitySettingsSection = 
                _configuration.GetSection("AppIdentitySettings");
            services.Configure<AppIdentitySettings>(identitySettingsSection);
            ...
        }
        ...
    }
}

3. Внедрить IOptions

И наконец, в контроллере / классе, который вы хотите получить значения, вам нужно ввести IOptions<AppIdentitySettings>через конструктор:

public class AccountController : Controller
{
    private readonly AppIdentitySettings _appIdentitySettings;

    public AccountController(IOptions<AppIdentitySettings> appIdentitySettingsAccessor)
    {
        _appIdentitySettings = appIdentitySettingsAccessor.Value;
    }

    [AllowAnonymous]
    public IActionResult ResetPassword(int userId, string code)
    {
        var vm = new ResetPasswordViewModel
        {
            PasswordRequiredLength = _appIdentitySettings.Password.RequiredLength,
            RequireUppercase = _appIdentitySettings.Password.RequireUppercase
        };

        return View(vm);
    }
}

Как я могу получить доступ к значениям в классе, который содержит мои данные?
Лукас Иеронимус Адлер

1
@LukasHieronimusAdler: Вы можете использовать IOptionsSnapshot<T>вместо IOptions<T>. Вы можете взглянуть на эту статью: offer.solutions/blog/articles/2017/02/17/… . Хотя у меня не было возможности попробовать это самому.
Дэвид Лян

2
Не могли бы вы сделать это просто, как фрагмент?
Саяфул Низам Яхья

8
Какой ужасный шаг назад от полного стека .net
Аарон

4
Итак, для .NET Core 3 вам нужен пакет Microsoft.Extensions.Options.ConfigurationExtensions, и он отлично работает
Томас Брукнер,

50

Просто создайте файл AnyName.cs и вставьте следующий код.

using System;
using System.IO;
using Microsoft.Extensions.Configuration;

namespace Custom
{
    static class ConfigurationManager
    {
        public static IConfiguration AppSetting { get; }
        static ConfigurationManager()
        {
            AppSetting = new ConfigurationBuilder()
                    .SetBasePath(Directory.GetCurrentDirectory())
                    .AddJsonFile("YouAppSettingFile.json")
                    .Build();
        }
    }
}

Необходимо заменить имя файла YouAppSettingFile.json на имя вашего файла.
Ваш файл .json должен выглядеть ниже.

{
    "GrandParent_Key" : {
        "Parent_Key" : {
            "Child_Key" : "value1"
        }
    },
    "Parent_Key" : {
        "Child_Key" : "value2"
    },
    "Child_Key" : "value3"
}

Теперь вы можете использовать его.
Не забудьте добавить ссылку в вашем классе, где вы хотите использовать.

using Custom;

Код для получения значения.

string value1 = ConfigurationManager.AppSetting["GrandParent_Key:Parent_Key:Child_Key"];
string value2 = ConfigurationManager.AppSetting["Parent_Key:Child_Key"];
string value3 = ConfigurationManager.AppSetting["Child_Key"];

3
Не используйте это в производстве. Именно этот подход вызвал утечки памяти в нашем веб-интерфейсе. Если вы используете netcore, вы можете вводить IConfiguration буквально в любом месте, просто посмотрите ответы выше.
Андре Мантас

49

Добавление к ответу Дэвида Ляна для Core 2.0 -

appsettings.jsonФайлы связаны с ASPNETCORE_ENVIRONMENTпеременной.

ASPNETCORE_ENVIRONMENTможет быть установлен на любое значение, но три значения поддерживаются структурой: Development, Stagingи Production. Если ASPNETCORE_ENVIRONMENTне установлен, по умолчанию будет Production.

Для этих трех значений этих appsettings.ASPNETCORE_ENVIRONMENT.json поддерживаются файлы из коробки - appsettings.Staging.json, appsettings.Development.jsonиappsettings.Production.json

Вышеупомянутые три приложения, устанавливающие файлы json, могут использоваться для настройки нескольких сред.

Пример - appsettings.Staging.json

{
    "Logging": {
        "IncludeScopes": false,
        "LogLevel": {
            "System": "Information",
            "Microsoft": "Information"
        }
    },
    "MyConfig": "My Config Value for staging."
}

Используйте Configuration["config_var"]для получения любого значения конфигурации.

public class Startup
{
    public Startup(IHostingEnvironment env, IConfiguration config)
    {
        Environment = env;
        Configuration = config;
        var myconfig = Configuration["MyConfig"];
    }

    public IConfiguration Configuration { get; }
    public IHostingEnvironment Environment { get; }
}

1
Как насчет вложенных объектов?
Артур Аттоут

8
Вложенные объекты могут быть получены с помощью конфигурации [«MyConfig: SomethingNested»]
WeHaveCookies

1
Как видно из файла github.com/aspnet/AspNetCore/blob/master/src/DefaultBuilder/src/… в строке 167 ASP.NET Core в настоящее время загружает appsettings.json+ appsettings.{env.EnvironmentName}.json. Поэтому утверждение о том, что ASP.NET Core загружает только файлы appsettings.json для разработчиков, промежуточных и производственных приложений, в настоящее время неверно.
19

1
так я должен ASPNETCORE_ENVIRONMENTкаждый раз устанавливать переменную Windows ? В .Net 4 все было намного проще. Эти фанатики JSON все
Toolkit

@Toolkit Вы можете установить переменную окружения глобально. docs.microsoft.com/en-us/aspnet/core/fundamentals/…
Асем Гаутам

29

Я думаю, самый простой способ - это DI. Пример достижения в контроллере.

// StartUp.cs
public void ConfigureServices(IServiceCollection services)
{
    ...
    // for get appsettings from anywhere
    services.AddSingleton(Configuration);
}

public class ContactUsController : Controller
{
    readonly IConfiguration _configuration;

    public ContactUsController(
        IConfiguration configuration)
    {
        _configuration = configuration;

        // sample:
        var apiKey = _configuration.GetValue<string>("SendGrid:CAAO");
        ...
    }
}

5
Читая другие ответы, это должно быть лучшим.
Харви

Я скучал services.AddSingleton(Configuration);, теперь это работает
Артур Медейрос

12

В конструкторе класса Startup вы можете получить доступ к appsettings.json и многим другим параметрам, используя внедренный объект IConfiguration:

Конструктор Startup.cs

    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;

        //here you go
        var myvalue = Configuration["Grandfather:Father:Child"];

    }

public IConfiguration Configuration { get; }

Содержимое appsettings.json

  {
  "Grandfather": {
    "Father": {
      "Child": "myvalue"
    }
  }

2
Мне помог синтаксис «Конфигурация [« дедушка: отец: ребенок »]».
Жак Оливье

2
Это выдающийся ответ в том, как он структурирован, понятен и точен. Отличное общение
jolySoft

6
    public static void GetSection()
    {
        Configuration = new ConfigurationBuilder()
            .SetBasePath(env.ContentRootPath)
            .AddJsonFile("appsettings.json")
            .Build();

        string BConfig = Configuration.GetSection("ConnectionStrings")["BConnection"];

    }

4
Неполный ответ
Carlos ABS

1

В моем случае это было просто, как использование метода Bind () для объекта Configuration. А затем добавить объект как синглтон в DI.

var instructionSettings = new InstructionSettings();
Configuration.Bind("InstructionSettings", instructionSettings);
services.AddSingleton(typeof(IInstructionSettings), (serviceProvider) => instructionSettings);

Объект Instruction может быть настолько сложным, насколько вы хотите.

{  
 "InstructionSettings": {
    "Header": "uat_TEST",
    "SVSCode": "FICA",
    "CallBackUrl": "https://UATEnviro.companyName.co.za/suite/webapi/receiveCallback",
    "Username": "s_integrat",
    "Password": "X@nkmail6",
    "Defaults": {
    "Language": "ENG",
    "ContactDetails":{
       "StreetNumber": "9",
       "StreetName": "Nano Drive",
       "City": "Johannesburg",
       "Suburb": "Sandton",
       "Province": "Gauteng",
       "PostCode": "2196",
       "Email": "ourDefaultEmail@companyName.co.za",
       "CellNumber": "0833 468 378",
       "HomeNumber": "0833 468 378",
      }
      "CountryOfBirth": "710"
    }
  }

1

Для ASP.NET Core 3.1 вы можете следовать этому руководству:

https://docs.microsoft.com/en-us/aspnet/core/fundamentals/configuration/?view=aspnetcore-3.1

При создании нового проекта ASP.NET Core 3.1 у вас будет следующая строка конфигурации Program.cs:

Host.CreateDefaultBuilder(args)

Это позволяет следующее:

  1. ChainedConfigurationProvider: добавляет существующую конфигурацию IConfiguration в качестве источника. В случае конфигурации по умолчанию добавляет конфигурацию хоста и устанавливает ее в качестве первого источника для конфигурации приложения.
  2. appsettings.json с использованием провайдера конфигурации JSON.
  3. appsettings.Environment.json с использованием провайдера конфигурации JSON. Например, appsettings.Production.json и appsettings.Development.json.
  4. Секреты приложения при запуске приложения в среде разработки.
  5. Переменные среды с использованием поставщика конфигурации переменных среды.
  6. Аргументы командной строки с использованием поставщика конфигурации командной строки.

Это означает, что вы можете вводить IConfigurationи извлекать значения с помощью строкового ключа, даже вложенные значения. подобноIConfiguration["Parent:Child"];

Пример:

appsettings.json

{
  "ApplicationInsights":
    {
        "Instrumentationkey":"putrealikeyhere"
    }
}

WeatherForecast.cs

[ApiController]
[Route("[controller]")]
public class WeatherForecastController : ControllerBase
{
    private static readonly string[] Summaries = new[]
    {
        "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
    };

    private readonly ILogger<WeatherForecastController> _logger;
    private readonly IConfiguration _configuration;

    public WeatherForecastController(ILogger<WeatherForecastController> logger, IConfiguration configuration)
    {
        _logger = logger;
        _configuration = configuration;
    }

    [HttpGet]
    public IEnumerable<WeatherForecast> Get()
    {
        var key = _configuration["ApplicationInsights:InstrumentationKey"];

        var rng = new Random();
        return Enumerable.Range(1, 5).Select(index => new WeatherForecast
        {
            Date = DateTime.Now.AddDays(index),
            TemperatureC = rng.Next(-20, 55),
            Summary = Summaries[rng.Next(Summaries.Length)]
        })
        .ToArray();
    }
}

Где я могу узнать больше о IConfiguration["Parent:Child"]синтаксисе?
xr280xr

0

Я думаю, что лучший вариант это:

  1. Создайте класс модели в качестве схемы конфигурации

  2. Зарегистрируйтесь в DI: services.Configure (Configuration.GetSection ("democonfig"));

  3. Получите значения как объект модели из DI в вашем контроллере:

    private readonly your_model myConfig;
    public DemoController(IOptions<your_model> configOps)
    {
        this.myConfig = configOps.Value;
    }

0

От Asp.net core 2.2 и выше вы можете написать код, как показано ниже:

Шаг 1. Создайте файл класса AppSettings.

Этот файл содержит несколько методов, помогающих получить значение по ключу из файла appsettings.json. Выглядит как код ниже:

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace ReadConfig.Bsl
{
  public class AppSettings
  {
      private static AppSettings _instance;
      private static readonly object ObjLocked = new object();
      private IConfiguration _configuration;

      protected AppSettings()
      {
      }

      public void SetConfiguration(IConfiguration configuration)
      {
          _configuration = configuration;
      }

      public static AppSettings Instance
      {
          get
          {
              if (null == _instance)
              {
                  lock (ObjLocked)
                  {
                      if (null == _instance)
                          _instance = new AppSettings();
                  }
              }
              return _instance;
          }
      }

      public string GetConnection(string key, string defaultValue = "")
      {
          try
          {
              return _configuration.GetConnectionString(key);
          }
          catch
          {
              return defaultValue;
          }
      }

      public T Get<T>(string key = null)
      {
          if (string.IsNullOrWhiteSpace(key))
              return _configuration.Get<T>();
          else
              return _configuration.GetSection(key).Get<T>();
      }

      public T Get<T>(string key, T defaultValue)
      {
          if (_configuration.GetSection(key) == null)
              return defaultValue;

          if (string.IsNullOrWhiteSpace(key))
              return _configuration.Get<T>();
          else
              return _configuration.GetSection(key).Get<T>();
      }

      public static T GetObject<T>(string key = null)
      {
          if (string.IsNullOrWhiteSpace(key))
              return Instance._configuration.Get<T>();
          else
          {
              var section = Instance._configuration.GetSection(key);
              return section.Get<T>();
          }
      }

      public static T GetObject<T>(string key, T defaultValue)
      {
          if (Instance._configuration.GetSection(key) == null)
              return defaultValue;

          if (string.IsNullOrWhiteSpace(key))
              return Instance._configuration.Get<T>();
          else
              return Instance._configuration.GetSection(key).Get<T>();
      }
  }
}

Шаг 2. Начальная настройка для объекта AppSettings

Нам нужно объявить и загрузить файл appsettings.json при запуске приложения, а также загрузить информацию о конфигурации для объекта AppSettings. Мы сделаем эту работу в конструкторе файла Startup.cs. Пожалуйста, обратите внимание на строкуAppSettings.Instance.SetConfiguration(Configuration);

public Startup(IHostingEnvironment evm)
{
    var builder = new ConfigurationBuilder()
      .SetBasePath(evm.ContentRootPath)
      .AddJsonFile("appsettings.json", true, true)
      .AddJsonFile($"appsettings.{evm.EnvironmentName}.json", true)
      .AddEnvironmentVariables();
    Configuration = builder.Build(); // load all file config to Configuration property 
    AppSettings.Instance.SetConfiguration(Configuration);       
}

Хорошо, теперь у меня есть файл appsettings.json с некоторыми ключами, как показано ниже:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "ConnectionString": "Data Source=localhost;Initial Catalog=ReadConfig;Persist Security Info=True;User ID=sa;Password=12345;"
  },
  "MailConfig": {
    "Servers": {
      "MailGun": {
        "Pass": "65-1B-C9-B9-27-00",
        "Port": "587",
        "Host": "smtp.gmail.com"
      }
    },
    "Sender": {
      "Email": "example@gmail.com",
      "Pass": "123456"
    }
  }
}

Шаг 3. Чтение значения конфигурации из действия

Я делаю демонстрацию в контроллере Home, как показано ниже:

public class HomeController : Controller
{
    public IActionResult Index()
    {
        var connectionString = AppSettings.Instance.GetConnection("ConnectionString");
        var emailSender = AppSettings.Instance.Get<string>("MailConfig:Sender:Email");
        var emailHost = AppSettings.Instance.Get<string>("MailConfig:Servers:MailGun:Host");

        string returnText = " 1. Connection String \n";
        returnText += "  " +connectionString;
        returnText += "\n 2. Email info";
        returnText += "\n Sender : " + emailSender;
        returnText += "\n Host : " + emailHost;

        return Content(returnText);
    }
}

И ниже результат:

Нажмите, чтобы увидеть результат

Для получения дополнительной информации вы можете обратиться к статье get value из appsettings.json в ядре asp.net для более детального кода.


0

Все просто: в appsettings.json

  "MyValues": {
    "Value1": "Xyz"
  }

В файле .cs:

static IConfiguration conf = (new ConfigurationBuilder().SetBasePath(Directory.GetCurrentDirectory()).AddJsonFile("appsettings.json").Build());
        public static string myValue1= conf["MyValues:Value1"].ToString();
Используя наш сайт, вы подтверждаете, что прочитали и поняли нашу Политику в отношении файлов cookie и Политику конфиденциальности.
Licensed under cc by-sa 3.0 with attribution required.