Note: come utilizzare Microsoft.Extensions.Options

2024-07-12

Innanzitutto, lo scopo:

Microsoft.Extensions.Options è una libreria in .NET Core per la gestione delle opzioni di configurazione. Fornisce un modo fortemente tipizzato per leggere e associare i dati di configurazione (come i dati da un file appsettings.json, variabili di ambiente o altre origini di configurazione) e inserirli nell'applicazione. Questa libreria fa parte di .NET Core, ma può essere usata anche in .NET Framework o altre implementazioni .NET.
Idea fondamentale

• Modello di opzioni: il modello di opzioni utilizza le classi per rappresentare raggruppamenti di dati di configurazione. Queste classi sono solitamente semplici POCO (Plain Old CLR Objects) contenenti alcune proprietà che corrispondono alle chiavi per i dati di configurazione.
• IOpzioni: IOpzioni<T> L'interfaccia viene utilizzata per accedere ai dati di configurazione di tipo T. Dopo aver registrato i dati di configurazione di tipo T, è possibile accedere a questi dati in altre parti dell'applicazione tramite l'inserimento delle dipendenze.
• IOptionsSnapshot: IOptionsSnapshot<T> Adatto per scenari in cui è necessario ricaricare i dati di configurazione mentre l'applicazione è in esecuzione. Fornisce una nuova istantanea dei dati di configurazione su ogni richiesta.
• IOptionsMonitor: IOptionsMonitor<T> Utilizzato per monitorare le modifiche nei dati di configurazione in tempo reale. Fornisce un evento di notifica di modifica che può essere attivato quando cambiano i dati di configurazione.

2. Esempio:

Supponiamo di avere un file di configurazione appsettings.json che contiene alcune impostazioni dell'applicazione:


{
  "MySettings": {
    "SettingA": "value1",
    "SettingB": "value2"
  }
}

Innanzitutto, definisci una classe per rappresentare queste impostazioni:


public class MySettings
{
    public string SettingA { get; set; }
    public string SettingB { get; set; }
}

Quindi, registra questa classe di configurazione nel metodo ConfigureServices di Startup.cs:


public void ConfigureServices(IServiceCollection services)
{
    // 绑定配置
    services.Configure<MySettings>(Configuration.GetSection("MySettings"));
    
    // 其他服务注册...
}

Ora puoi accedere a queste impostazioni tramite l'inserimento delle dipendenze ovunque sia necessario:


public class MyService
{
    private readonly MySettings _mySettings;
 
    public MyService(IOptions<MySettings> options)
    {
        _mySettings = options.Value;
    }
 
    public void DoSomething()
    {
        Console.WriteLine(_mySettings.SettingA);
        // 使用 _mySettings...
    }
}

Microsoft.Extensions.Options fornisce un modo semplice ma potente per gestire e accedere ai dati di configurazione di un'applicazione. Utilizzando classi di configurazione fortemente tipizzate e l'inserimento delle dipendenze, puoi integrare facilmente i dati di configurazione nella tua applicazione mantenendo il codice chiaro e gestibile.

Condivisione della tecnologia