Microsoft.Extensions.Options.ConfigurationExtensions 9.0.4

About

Microsoft.Extensions.Options.ConfigurationExtensions provides additional configuration-specific functionality related to Options.

Key Features

  • Extension methods for OptionsBuilder for configuration binding
  • Extension methods for IServiceCollection for Options configuration
  • ConfigurationChangeTokenSource for monitoring configuration changes

How to Use

Options Configuration binding

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

class Program
{
    // appsettings.json contents:
    // {
    //   "MyOptions": {
    //     "Setting1": "Value1",
    //     "Setting2": "Value2"
    //   }
    // }

    static void Main(string[] args)
    {
        IConfiguration configuration = new ConfigurationBuilder()
            .SetBasePath(Environment.CurrentDirectory)
            .AddJsonFile("appsettings.json")
            .Build();

        IServiceCollection services = new ServiceCollection();

        // Bind the configuration to MyOptions
        services.Configure<MyOptions>(configuration.GetSection("MyOptions"));

        IServiceProvider serviceProvider = services.BuildServiceProvider();

        // Retrieve MyOptions using dependency injection
        var myOptions = serviceProvider.GetRequiredService<IOptions<MyOptions>>().Value;

        // Access the bound configuration values
        Console.WriteLine($"Setting1: {myOptions.Setting1}");
        Console.WriteLine($"Setting2: {myOptions.Setting2}");
    }
}

public class MyOptions
{
    public string Setting1 { get; set; }
    public string Setting2 { get; set; }
}

Monitoring options configuration changes

// Assume we have a class that represents some options
public class MyOptions
{
    public string Name { get; set; }
    public int Age { get; set; }
}

// appsettings.json contents:
// {
//   "MyOptions": {
//     "Name": "Alice",
//     "Age": 25
//   }
// }

// Assume we have a configuration object that contains some settings
var config = new ConfigurationBuilder()
    .AddJsonFile("appsettings.json")
    .Build();

// We can use the ConfigurationChangeTokenSource to create a change token source for the options
var changeTokenSource = new ConfigurationChangeTokenSource<MyOptions>(config.GetSection("MyOptions"));

// We can register the change token source with the options monitor
services.AddOptions<MyOptions>()
    .Configure(options =>
    {
        // Configure the options with the configuration values
        config.GetSection("MyOptions").Bind(options);
    })
    .AddChangeTokenSource(changeTokenSource);

// Now we can inject the options monitor into any class that needs them
public class MyClass
{
    private readonly IOptionsMonitor<MyOptions> _optionsMonitor;

    public MyClass(IOptionsMonitor<MyOptions> optionsMonitor)
    {
        _optionsMonitor = optionsMonitor;
    }

    public void DoSomething()
    {
        // Can access the current options value like this
        var options = _optionsMonitor.CurrentValue;
        var name = options.Name;
        var age = options.Age;
        // Do something with name and age

        // Can also register a callback to be notified when the options change
        _optionsMonitor.OnChange(newOptions =>
        {
            // Do something when the options change
        });
    }
}

Main Types

The main types provided by this library are:

  • ConfigurationChangeTokenSource
  • OptionsBuilderConfigurationExtensions
  • OptionsConfigurationServiceCollectionExtensions

Additional Documentation

Feedback & Contributing

Microsoft.Extensions.Options.ConfigurationExtensions is released as open source under the MIT license. Bug reports and contributions are welcome at the GitHub repository.

Showing the top 20 packages that depend on Microsoft.Extensions.Options.ConfigurationExtensions.

Packages Downloads
Microsoft.AspNetCore
Microsoft.AspNetCore
 8
Microsoft.Extensions.Diagnostics
This package includes the default implementation of IMeterFactory and additional extension methods to easily register it with the Dependency Injection framework.
 8
SixLabors.ImageSharp.Web
ImageSharp Middleware for serving images via a url based API.
 8
Microsoft.Extensions.Resilience
Extensions to the Polly libraries to enrich telemetry with metadata and exception summaries.
 8
Serilog.Settings.Configuration
Microsoft.Extensions.Configuration (appsettings.json) support for Serilog.
 8
Betalgo.OpenAI
Dotnet SDK for OpenAI ChatGPT, Whisper, GPT-4 and DALL·E
 7
IdentityServer4
OpenID Connect and OAuth 2.0 Framework for ASP.NET Core
 7
Microsoft.AspNetCore
Microsoft.AspNetCore
 7

https://go.microsoft.com/fwlink/?LinkID=799421

.NET Framework 4.6.2

.NET Standard 2.0

.NET 9.0

.NET 8.0

Version Downloads Last updated
10.0.1 1 10.12.2025
10.0.0 0 11.11.2025
10.0.0-rc.2.25502.107 0 14.10.2025
10.0.0-rc.1.25451.107 1 10.11.2025
10.0.0-preview.7.25380.108 3 17.08.2025
10.0.0-preview.6.25358.103 3 17.08.2025
10.0.0-preview.5.25277.114 4 11.07.2025
10.0.0-preview.4.25258.110 1 11.07.2025
10.0.0-preview.3.25171.5 1 11.07.2025
10.0.0-preview.2.25163.2 3 27.03.2025
10.0.0-preview.1.25080.5 4 09.03.2025
9.0.11 0 11.11.2025
9.0.10 1 04.11.2025
9.0.9 0 09.09.2025
9.0.8 1 17.08.2025
9.0.7 1 17.08.2025
9.0.6 2 10.07.2025
9.0.5 2 10.07.2025
9.0.4 2 10.07.2025
9.0.3 3 27.03.2025
9.0.2 4 20.02.2025
9.0.1 4 20.02.2025
9.0.0 4 20.02.2025
9.0.0-rc.2.24473.5 6 27.03.2025
9.0.0-rc.1.24431.7 6 27.03.2025
9.0.0-preview.7.24405.7 3 27.03.2025
9.0.0-preview.6.24327.7 6 27.03.2025
9.0.0-preview.5.24306.7 6 27.03.2025
9.0.0-preview.4.24266.19 4 27.03.2025
9.0.0-preview.3.24172.9 6 27.03.2025
9.0.0-preview.2.24128.5 3 27.03.2025
9.0.0-preview.1.24080.9 4 27.03.2025
8.0.0 5 21.12.2024
8.0.0-rc.2.23479.6 6 27.03.2025
8.0.0-rc.1.23419.4 6 27.03.2025
8.0.0-preview.7.23375.6 6 27.03.2025
8.0.0-preview.6.23329.7 6 27.03.2025
8.0.0-preview.5.23280.8 4 20.02.2025
8.0.0-preview.4.23259.5 6 27.03.2025
8.0.0-preview.3.23174.8 7 27.03.2025
8.0.0-preview.2.23128.3 4 20.02.2025
8.0.0-preview.1.23110.8 4 20.02.2025
7.0.0 4 20.02.2025
7.0.0-rc.2.22472.3 8 20.02.2025
7.0.0-rc.1.22426.10 4 27.03.2025
7.0.0-preview.7.22375.6 4 27.03.2025
7.0.0-preview.6.22324.4 3 27.03.2025
7.0.0-preview.5.22301.12 3 27.03.2025
7.0.0-preview.4.22229.4 3 27.03.2025
7.0.0-preview.3.22175.4 7 27.03.2025
7.0.0-preview.2.22152.2 5 20.02.2025
7.0.0-preview.1.22076.8 3 27.03.2025
6.0.1 4 20.02.2025
6.0.0 4 20.02.2025
6.0.0-rc.2.21480.5 6 27.03.2025
6.0.0-rc.1.21451.13 3 27.03.2025
6.0.0-preview.7.21377.19 4 27.03.2025
6.0.0-preview.6.21352.12 3 27.03.2025
6.0.0-preview.5.21301.5 6 20.02.2025
6.0.0-preview.4.21253.7 6 27.03.2025
6.0.0-preview.3.21201.4 3 27.03.2025
6.0.0-preview.2.21154.6 4 27.03.2025
6.0.0-preview.1.21102.12 3 27.03.2025
5.0.0 5 25.11.2024
5.0.0-rc.2.20475.5 7 27.03.2025
5.0.0-rc.1.20451.14 3 27.03.2025
5.0.0-preview.8.20407.11 4 27.03.2025
5.0.0-preview.7.20364.11 4 27.03.2025
5.0.0-preview.6.20305.6 4 20.02.2025
5.0.0-preview.5.20278.1 4 27.03.2025
5.0.0-preview.4.20251.6 4 27.03.2025
5.0.0-preview.3.20215.2 4 20.02.2025
5.0.0-preview.2.20160.3 3 27.03.2025
5.0.0-preview.1.20120.4 3 27.03.2025
3.1.32 3 27.03.2025
3.1.31 3 27.03.2025
3.1.30 3 27.03.2025
3.1.29 3 27.03.2025
3.1.28 4 27.03.2025
3.1.27 3 27.03.2025
3.1.26 3 27.03.2025
3.1.25 4 27.03.2025
3.1.24 3 27.03.2025
3.1.23 3 27.03.2025
3.1.22 4 27.03.2025
3.1.21 3 27.03.2025
3.1.20 4 27.03.2025
3.1.19 3 27.03.2025
3.1.18 3 27.03.2025
3.1.17 3 27.03.2025
3.1.16 3 27.03.2025
3.1.15 3 27.03.2025
3.1.14 3 27.03.2025
3.1.13 3 27.03.2025
3.1.12 4 27.03.2025
3.1.11 3 27.03.2025
3.1.10 3 27.03.2025
3.1.9 4 20.02.2025
3.1.8 4 20.02.2025
3.1.7 4 20.02.2025
3.1.6 4 20.02.2025
3.1.5 4 20.02.2025
3.1.4 4 20.02.2025
3.1.3 4 20.02.2025
3.1.2 4 20.02.2025
3.1.1 4 20.02.2025
3.1.0 4 20.02.2025
3.1.0-preview3.19553.2 3 27.03.2025
3.1.0-preview2.19525.4 4 27.03.2025
3.1.0-preview1.19506.1 3 27.03.2025
3.0.3 5 20.02.2025
3.0.2 4 20.02.2025
3.0.1 4 20.02.2025
3.0.0 4 20.02.2025
3.0.0-rc1.19456.10 4 20.02.2025
3.0.0-preview9.19423.4 4 27.03.2025
3.0.0-preview8.19405.4 3 27.03.2025
3.0.0-preview7.19362.4 3 27.03.2025
3.0.0-preview6.19304.6 3 27.03.2025
3.0.0-preview5.19227.9 3 27.03.2025
3.0.0-preview4.19216.2 3 27.03.2025
3.0.0-preview3.19153.1 4 20.02.2025
3.0.0-preview.19074.2 3 27.03.2025
3.0.0-preview.18572.1 3 27.03.2025
2.2.0 4 20.02.2025
2.2.0-preview3-35497 3 27.03.2025
2.2.0-preview2-35157 4 27.03.2025
2.2.0-preview1-35029 3 27.03.2025
2.1.1 4 20.02.2025
2.1.0 4 20.02.2025
2.1.0-rc1-final 4 20.02.2025
2.1.0-preview2-final 4 27.03.2025
2.1.0-preview1-final 3 27.03.2025
2.0.2 7 20.02.2025
2.0.1 5 20.02.2025
2.0.0 5 20.02.2025
2.0.0-preview2-final 4 20.02.2025
2.0.0-preview1-final 4 27.03.2025
1.1.2 4 20.02.2025
1.1.1 4 20.02.2025
1.1.0 4 20.02.2025
1.1.0-preview1-final 4 20.02.2025
1.0.2 5 20.02.2025
1.0.1 5 20.02.2025
1.0.0 4 20.02.2025
1.0.0-rc2-final 4 20.02.2025