Tra le novità portate in dote da ASP.NET Core non poteva mancare una piccola rivoluzione dal punto di vista della configurazione.

Sicuramente ci saremo resi conto più volte di come il meccanismo degli AppSettings presente in ASP.NET abbia notevoli limiti, primo tra tutti il fatto che si tratti di una struttura piatta, basata sul concetto semplicistico di coppie chiave-valore, che non consente facilmente la scrittura di impostazioni strutturate. Sebbene sia possibile definire una sezione personalizzata in web.config, il codice resta comunque piuttosto scomodo.

In ASP.NET Core, la sezione AppSettings di web.config lascia il posto ad un file appsettings.json, all'interno del quale possiamo memorizzare dati in forma gerarchica, sfruttando il formato JSON. Il codice in basso, oltre ai setting per il logging, include un esempio di impostazioni per accedere a un web service remoto.

{
  "Logging": {
    "IncludeScopes": false,
    "LogLevel": {
      "Default": "Debug",
      "System": "Information",
      "Microsoft": "Information"
    }
  },
  "myRemoteService": {
    "url": "http://service.com",
    "username": "user",
    "password": "pass"
  }
}

Quest'ultima può essere rappresentata da una classe come la seguente:

public class WebServiceSettings
{
    public string Url { get; set; }
    public string Username { get; set; }
    public string Password { get; set; }
}

che possiamo poi referenziare all'interno di un controller grazie all'interfaccia IOptions<T>:

public HomeController(IOptions<WebServiceSettings> config)
{
    _settings = config.Value;
}

Affinché il Runtime sappia come istanziare WebServiceSettings, però, dobbiamo registrare un nuovo servizio sul container di ASP.NET Core, aggiungendo queste righe al metodo ConfigureServices in Startup.cs:

public void ConfigureServices(IServiceCollection services)
{
  // ... altro codice ...

  services.AddOptions();

  services.Configure<WebServiceSettings>(
    this.Configuration.GetSection("myRemoteService"));
}

Il metodo AddOptions è quello che registra il servizio IOptions<T> che abbiamo sfruttato nel controller precedente. Il secondo metodo, invece, serve ad associare la particolare classe WebServiceSettings alla sezione myRemoteService di appconfig.json.