Microsoft.Extensions.Options.ConfigurationExtensions 9.0.22
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:
ConfigurationChangeTokenSourceOptionsBuilderConfigurationExtensionsOptionsConfigurationServiceCollectionExtensions
Additional Documentation
Related Packages
- Microsoft.Extensions.Options
- Microsoft.Extensions.Configuration
- Microsoft.Extensions.DependencyInjection
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 |
|---|---|
|
App.Metrics
App Metrics is an open-source and cross-platform .NET library used to record and monitor application metrics and health.
|
40 |
|
App.Metrics
App Metrics is an open-source and cross-platform .NET library used to record and monitor application metrics and health.
|
45 |
|
IdentityServer4
OpenID Connect and OAuth 2.0 Framework for ASP.NET Core
|
40 |
|
Microsoft.AspNetCore
Microsoft.AspNetCore
|
44 |
|
Microsoft.AspNetCore
Microsoft.AspNetCore
|
46 |
|
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging.
|
39 |
|
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging.
|
162 |
|
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging.
|
515 |
|
Microsoft.Extensions.Logging.Configuration
Configuration support for Microsoft.Extensions.Logging.
This package was built from the source code at https://github.com/aspnet/Extensions/tree/9bc79b2f25a3724376d7af19617c33749a30ea3a
|
752 |
|
Microsoft.Identity.Web.TokenAcquisition
Implementation for higher level API for confidential client applications (ASP.NET Core and SDK/.NET).
|
42 |
|
OctaPull.RealTimeNotification.Connect
OctaPull RealTime Notification API Client Library
|
51 |
|
Serilog.Settings.Configuration
Microsoft.Extensions.Configuration (appsettings.json) support for Serilog.
|
750 |
|
Serilog.Sinks.MSSqlServer
A Serilog sink that writes events to Microsoft SQL Server
|
40 |
|
Serilog.Sinks.MSSqlServer
A Serilog sink that writes events to Microsoft SQL Server
|
41 |
|
Serilog.Sinks.MSSqlServer
A Serilog sink that writes events to Microsoft SQL Server and Azure SQL
|
41 |
|
Serilog.Sinks.MSSqlServer
A Serilog sink that writes events to Microsoft SQL Server and Azure SQL
|
42 |
https://go.microsoft.com/fwlink/?LinkID=799421
.NET Framework 4.6.2
- Microsoft.Extensions.Configuration.Abstractions (>= 9.0.22)
- Microsoft.Extensions.Primitives (>= 9.0.22)
- Microsoft.Extensions.Options (>= 9.0.22)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.22)
- Microsoft.Extensions.Configuration.Binder (>= 9.0.22)
.NET Standard 2.0
- Microsoft.Extensions.Primitives (>= 9.0.22)
- Microsoft.Extensions.Options (>= 9.0.22)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.22)
- Microsoft.Extensions.Configuration.Binder (>= 9.0.22)
- Microsoft.Extensions.Configuration.Abstractions (>= 9.0.22)
.NET 9.0
- Microsoft.Extensions.Primitives (>= 9.0.22)
- Microsoft.Extensions.Options (>= 9.0.22)
- Microsoft.Extensions.Configuration.Binder (>= 9.0.22)
- Microsoft.Extensions.Configuration.Abstractions (>= 9.0.22)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.22)
.NET 8.0
- Microsoft.Extensions.Options (>= 9.0.22)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.22)
- Microsoft.Extensions.Configuration.Binder (>= 9.0.22)
- Microsoft.Extensions.Configuration.Abstractions (>= 9.0.22)
- Microsoft.Extensions.Primitives (>= 9.0.22)
| Version | Downloads | Last updated |
|---|---|---|
| 11.0.0-rc.3.26522.148 | 1 | 10/27/2026 |
| 11.0.0-rc.2.26504.105 | 2 | 10/17/2026 |
| 11.0.0-rc.1.26425.128 | 4 | 09/21/2026 |
| 11.0.0-preview.7.26381.103 | 3 | 08/15/2026 |
| 11.0.0-preview.6.26359.118 | 3 | 07/26/2026 |
| 11.0.0-preview.5.26302.115 | 12 | 06/15/2026 |
| 11.0.0-preview.4.26230.115 | 12 | 05/26/2026 |
| 11.0.0-preview.3.26207.106 | 4 | 04/15/2026 |
| 11.0.0-preview.2.26159.112 | 19 | 03/11/2026 |
| 11.0.0-preview.1.26104.118 | 17 | 02/12/2026 |
| 10.0.14 | 1 | 10/27/2026 |
| 10.0.13 | 2 | 10/17/2026 |
| 10.0.12 | 2 | 09/24/2026 |
| 10.0.11 | 3 | 08/15/2026 |
| 10.0.10 | 7 | 07/26/2026 |
| 10.0.9 | 9 | 06/15/2026 |
| 10.0.8 | 15 | 05/26/2026 |
| 10.0.7 | 16 | 05/06/2026 |
| 10.0.6 | 14 | 04/15/2026 |
| 10.0.5 | 13 | 03/14/2026 |
| 10.0.4 | 18 | 03/11/2026 |
| 10.0.3 | 18 | 02/12/2026 |
| 10.0.2 | 19 | 01/16/2026 |
| 10.0.1 | 10 | 12/12/2025 |
| 10.0.0 | 23 | 11/13/2025 |
| 10.0.0-rc.2.25502.107 | 21 | 10/18/2025 |
| 10.0.0-rc.1.25451.107 | 24 | 09/11/2025 |
| 10.0.0-preview.7.25380.108 | 27 | 08/15/2025 |
| 10.0.0-preview.6.25358.103 | 26 | 07/16/2025 |
| 10.0.0-preview.5.25277.114 | 30 | 06/07/2025 |
| 10.0.0-preview.4.25258.110 | 17 | 05/13/2025 |
| 10.0.0-preview.3.25171.5 | 30 | 04/25/2025 |
| 10.0.0-preview.2.25163.2 | 23 | 03/20/2025 |
| 10.0.0-preview.1.25080.5 | 19 | 02/25/2025 |
| 9.0.22 | 1 | 10/27/2026 |
| 9.0.21 | 2 | 10/17/2026 |
| 9.0.20 | 2 | 09/24/2026 |
| 9.0.19 | 2 | 08/15/2026 |
| 9.0.18 | 5 | 07/26/2026 |
| 9.0.17 | 10 | 06/15/2026 |
| 9.0.16 | 13 | 05/26/2026 |
| 9.0.15 | 7 | 04/15/2026 |
| 9.0.14 | 19 | 03/11/2026 |
| 9.0.13 | 16 | 02/12/2026 |
| 9.0.12 | 17 | 01/16/2026 |
| 9.0.11 | 18 | 11/13/2025 |
| 9.0.10 | 15 | 10/18/2025 |
| 9.0.9 | 17 | 09/11/2025 |
| 9.0.8 | 22 | 08/07/2025 |
| 9.0.7 | 20 | 07/17/2025 |
| 9.0.6 | 20 | 06/15/2025 |
| 9.0.5 | 26 | 06/29/2025 |
| 9.0.4 | 26 | 04/26/2025 |
| 9.0.3 | 19 | 03/20/2025 |
| 9.0.2 | 26 | 02/26/2025 |
| 9.0.1 | 29 | 01/18/2025 |
| 9.0.0 | 37 | 01/18/2025 |
| 9.0.0-rc.2.24473.5 | 26 | 01/18/2025 |
| 9.0.0-rc.1.24431.7 | 29 | 12/06/2024 |
| 9.0.0-preview.7.24405.7 | 20 | 01/18/2025 |
| 9.0.0-preview.6.24327.7 | 25 | 01/18/2025 |
| 9.0.0-preview.5.24306.7 | 26 | 01/18/2025 |
| 9.0.0-preview.4.24266.19 | 30 | 01/18/2025 |
| 9.0.0-preview.3.24172.9 | 26 | 01/18/2025 |
| 9.0.0-preview.2.24128.5 | 27 | 01/18/2025 |
| 9.0.0-preview.1.24080.9 | 26 | 02/15/2024 |
| 8.0.0 | 33 | 03/07/2024 |
| 8.0.0-rc.2.23479.6 | 30 | 03/07/2024 |
| 8.0.0-rc.1.23419.4 | 35 | 01/18/2025 |
| 8.0.0-preview.7.23375.6 | 29 | 03/11/2024 |
| 8.0.0-preview.6.23329.7 | 28 | 03/10/2024 |
| 8.0.0-preview.5.23280.8 | 19 | 03/14/2024 |
| 8.0.0-preview.4.23259.5 | 32 | 03/10/2024 |
| 8.0.0-preview.3.23174.8 | 28 | 03/09/2024 |
| 8.0.0-preview.2.23128.3 | 30 | 03/09/2024 |
| 8.0.0-preview.1.23110.8 | 31 | 02/27/2024 |
| 7.0.0 | 156 | 08/18/2023 |
| 7.0.0-rc.2.22472.3 | 25 | 03/06/2024 |
| 7.0.0-rc.1.22426.10 | 29 | 03/07/2024 |
| 7.0.0-preview.7.22375.6 | 25 | 03/08/2024 |
| 7.0.0-preview.6.22324.4 | 28 | 03/07/2024 |
| 7.0.0-preview.5.22301.12 | 27 | 03/09/2024 |
| 7.0.0-preview.4.22229.4 | 28 | 03/08/2024 |
| 7.0.0-preview.3.22175.4 | 22 | 03/07/2024 |
| 7.0.0-preview.2.22152.2 | 31 | 03/08/2024 |
| 7.0.0-preview.1.22076.8 | 28 | 03/07/2024 |
| 6.0.2-mauipre.1.22102.15 | 27 | 03/15/2024 |
| 6.0.2-mauipre.1.22054.8 | 26 | 03/15/2024 |
| 6.0.1 | 20 | 01/18/2025 |
| 6.0.0 | 46 | 08/18/2023 |
| 6.0.0-rc.2.21480.5 | 30 | 03/02/2024 |
| 6.0.0-rc.1.21451.13 | 30 | 03/15/2024 |
| 6.0.0-preview.7.21377.19 | 22 | 03/11/2024 |
| 6.0.0-preview.6.21352.12 | 28 | 03/09/2024 |
| 6.0.0-preview.5.21301.5 | 26 | 11/03/2023 |
| 6.0.0-preview.4.21253.7 | 28 | 03/10/2024 |
| 6.0.0-preview.3.21201.4 | 31 | 03/10/2024 |
| 6.0.0-preview.2.21154.6 | 26 | 01/18/2025 |
| 6.0.0-preview.1.21102.12 | 28 | 03/09/2024 |
| 5.0.0 | 29 | 03/15/2024 |
| 5.0.0-rc.2.20475.5 | 30 | 03/11/2024 |
| 5.0.0-rc.1.20451.14 | 33 | 03/10/2024 |
| 5.0.0-preview.8.20407.11 | 32 | 03/14/2024 |
| 5.0.0-preview.7.20364.11 | 26 | 03/14/2024 |
| 5.0.0-preview.6.20305.6 | 31 | 03/14/2024 |
| 5.0.0-preview.5.20278.1 | 28 | 03/14/2024 |
| 5.0.0-preview.4.20251.6 | 19 | 03/11/2024 |
| 5.0.0-preview.3.20215.2 | 29 | 03/07/2024 |
| 5.0.0-preview.2.20160.3 | 24 | 03/11/2024 |
| 5.0.0-preview.1.20120.4 | 20 | 03/10/2024 |
| 3.1.32 | 50 | 02/26/2024 |
| 3.1.31 | 33 | 03/15/2024 |
| 3.1.30 | 40 | 03/15/2024 |
| 3.1.29 | 31 | 03/15/2024 |
| 3.1.28 | 29 | 03/15/2024 |
| 3.1.27 | 27 | 03/15/2024 |
| 3.1.26 | 22 | 11/17/2023 |
| 3.1.25 | 27 | 03/15/2024 |
| 3.1.24 | 32 | 03/15/2024 |
| 3.1.23 | 32 | 03/15/2024 |
| 3.1.22 | 29 | 10/31/2023 |
| 3.1.21 | 33 | 02/27/2024 |
| 3.1.20 | 33 | 03/15/2024 |
| 3.1.19 | 30 | 03/06/2024 |
| 3.1.18 | 35 | 03/07/2024 |
| 3.1.17 | 27 | 03/15/2024 |
| 3.1.16 | 21 | 03/15/2024 |
| 3.1.15 | 21 | 03/22/2024 |
| 3.1.14 | 35 | 03/22/2024 |
| 3.1.13 | 26 | 03/22/2024 |
| 3.1.12 | 27 | 03/15/2024 |
| 3.1.11 | 29 | 03/15/2024 |
| 3.1.10 | 23 | 03/15/2024 |
| 3.1.9 | 31 | 03/07/2024 |
| 3.1.8 | 28 | 03/02/2024 |
| 3.1.7 | 24 | 03/15/2024 |
| 3.1.6 | 29 | 03/15/2024 |
| 3.1.5 | 35 | 03/15/2024 |
| 3.1.4 | 33 | 03/18/2024 |
| 3.1.3 | 22 | 03/15/2024 |
| 3.1.2 | 29 | 03/15/2024 |
| 3.1.1 | 25 | 03/07/2024 |
| 3.1.0 | 32 | 03/15/2024 |
| 3.1.0-preview3.19553.2 | 26 | 03/07/2024 |
| 3.1.0-preview2.19525.4 | 29 | 03/09/2024 |
| 3.1.0-preview1.19506.1 | 28 | 03/08/2024 |
| 3.0.3 | 30 | 03/15/2024 |
| 3.0.2 | 35 | 03/15/2024 |
| 3.0.1 | 27 | 03/01/2024 |
| 3.0.0 | 30 | 11/07/2023 |
| 3.0.0-rc1.19456.10 | 21 | 03/09/2024 |
| 3.0.0-preview9.19423.4 | 28 | 03/14/2024 |
| 3.0.0-preview8.19405.4 | 32 | 03/14/2024 |
| 3.0.0-preview7.19362.4 | 33 | 03/10/2024 |
| 3.0.0-preview6.19304.6 | 26 | 03/11/2024 |
| 3.0.0-preview5.19227.9 | 33 | 03/11/2024 |
| 3.0.0-preview4.19216.2 | 35 | 03/10/2024 |
| 3.0.0-preview3.19153.1 | 33 | 03/11/2024 |
| 3.0.0-preview.19074.2 | 35 | 03/14/2024 |
| 3.0.0-preview.18572.1 | 27 | 03/09/2024 |
| 2.2.0 | 749 | 08/18/2023 |
| 2.2.0-preview3-35497 | 30 | 03/09/2024 |
| 2.2.0-preview2-35157 | 21 | 03/08/2024 |
| 2.2.0-preview1-35029 | 33 | 03/08/2024 |
| 2.1.1 | 516 | 08/18/2023 |
| 2.1.0 | 21 | 03/06/2024 |
| 2.1.0-rc1-final | 33 | 03/06/2024 |
| 2.1.0-preview2-final | 26 | 11/05/2023 |
| 2.1.0-preview1-final | 31 | 01/18/2025 |
| 2.0.2 | 23 | 03/15/2024 |
| 2.0.1 | 22 | 03/15/2024 |
| 2.0.0 | 734 | 08/18/2023 |
| 2.0.0-preview2-final | 22 | 03/07/2024 |
| 2.0.0-preview1-final | 18 | 01/18/2025 |
| 1.1.2 | 35 | 03/15/2024 |
| 1.1.1 | 24 | 03/15/2024 |
| 1.1.0 | 43 | 03/06/2024 |
| 1.1.0-preview1-final | 24 | 03/08/2024 |
| 1.0.2 | 28 | 01/03/2025 |
| 1.0.1 | 28 | 03/15/2024 |
| 1.0.0 | 29 | 03/15/2024 |
| 1.0.0-rc2-final | 31 | 03/07/2024 |