Знакомство с интефейсом IOptions¶

Пусть мы хотим связать раздел настроек AppDisplaySettingsиз этого раздела с POCO классом. Тогда он будет иметь такой вид:

public class AppDisplaySettings
{
    public string Title { get; set; }
    public bool ShowCopyright { get; set; }
}

public IConfiguration Configuration { get; }
public void ConfigureServices(IServiceCollection services)
{
    services.Configure<MapSettings>(
        Configuration.GetSection("MapSettings"));
    services.Configure<AppDisplaySettings>(
        Configuration.GetSection("AppDisplaySettings"));
}

1. Создает экземпляр ConfigureOptions<T>, который указывает, что IOptions<T> должен быть настроен на основе конфигурации. Если Configure<T> вызывается несколько раз, будет создано несколько объектов ConfigureOptions<T>;
2. Каждый экземпляр ConfigureOptions<T> привязывает секцию IConfiguration к экземпляру POCO класса T. Все открытые свойства этого класса задаются на основе ключей из предоставленной ConfigurationSection;
3. Интерфейс IOptions<T> регистрируется в контейнере зависимостей как синглтон, с привязанным объектом POCO в свойстве Value.

Если Configure<T> не будет вызван, при внедрении IOptions<T> объект класса параметров будет иметь значения свойств по умолчанию.

Если требуется, чтобы конфигурация поддерживала обновление значений параметров “на горячую”, вместо IOptions<T> нужно использовать IOptionsSnapshot<T>.

Комментарии

Комментарии